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Format  Rules  for  S-3  Input  Statements 


A-  GENERAL 

1.  Labels,  op-codes,  and  operands  must  not  contain 
imbedded  spaces . 

2.  Labels,  op-codes,  and  operands  must  be  followed 
by  at  least  one  space. 

3.  Comments  may  appear  on  any  line  of  coding  after 
the  last  operand  and  continue  up  to  column  80. 

4.  Sequence  numbers,  if  desired,  are  considered 
to  be  part  of  the  comment. 

B.  LABELS 

1.  All  labels  must  start  in  column  1. 

2.  Labels  must  not  exceed  12  characters  in  length. 

3.  The  first  character  of  each  label  must  be  alphabetic. 

4.  Labels  are  not  permitted  on  the  JOB,  OF,  MEM-1, 
or  MEM-2  statements. 

C .  OP-CODES 

1.  Op-codes  may  start  anywhere  except  in  column  1. 

2.  Op-codes  must  be  spelled  exactly  as  specified 


in  this  manual 


ii 

D .  OPERANDS 

1.  The  first  operand  must  be  preceeded  by  an  op-code 
and  at  least  one  space  but  no  more  than  10  spaces. 

2.  Operands  must  not  exceed  12  characters  in  length. 

3.  Operands  must  be  separated  by  a  comma. 

4.  No  spaces  may  appear  between  operands  but  a 
space  must  appear  after  the  last  operand. 

5.  Operands  may  be  continued  onto  the  next  line  by 
following  the  last  operand  of  the  first  line 
with  a  comma  and  a  space  and  starting  the  first 
operand  of  the  following  lines  in  other  than 


column  1 


iii 

Rules  for  Organisation  of  Worker  Routines 

1.  The  first  statement  of  every  VJ/R  must  be  the  JOB 
statement . 

2.  The  OF  statements  must  immediately  follow  the  JOB 
statement.  There  must  be  one  OF  statement  for  each 
file  referenced  within  the  W/R.  If  no  files  are 
referenced,  then  no  OF  statements  should  appear. 

3.  There  must  be  a  MBM-1  statement  for  each  W/R.  Tne 
MEM-1  statement  must  appear  after  the  OF  statements, 
if  there  are  any,  or  after  the  JOB  statement  if  there 
are  no  OF  statements. 

4.  The  last  statement  of  every  W/R  mast  be  a  TERM 


statement 


1 


CPU  Definition 


The  CPU  definition  statement  is  used  to  supply 


the  simulator  with  a  description  of  the  central  processor 
unit  or  units  which  are  to  be  used  for  this  run. 


STATEMENT  FORMAT 

1 

LABEL  1 

1 

OP -CD 

OPERA^.'DS 

CPU-DEF 

cpu-id  ( ,LIB,CAT,NCAT) 

(epu  hardware  definition 

cards  type  01  and  02,  see  appendix  A) 

CPU -END 

cpu-id 

The  "cpu~id"  field  must  contain  the  name  (limited 


to  6  characters)  by  which  this  CPU  definition  will  be  refer¬ 
enced  by  the  configuration  data.  The  use  of  this  field 
is  governed  by  the  option  chosen  for  the  following  field. 

LIB 

The  LIB  option  specifies  that  the  desired  CPU 


definition  may  be  found  in  the  system  library  and  that 
the  CPU  definition  cards,  tjrpes  01  and  02  are  not  included. 


The  CPU  definition  in  the  library  must  have  the  same 
name  as  the  field  "cpu-id".  If  the  LIB  option  is 
selected,  the  CPU-END  statement  must  be  omitted. 

CAT 

The  CAT  option  specifies  that  the  desired  CPU 
definition  will  be  found  on  the  next  two  cards,  types  01 
and  02  (see  appendix  A),  tn  addition,  this  option  will 
cause  the  CPU  definitions  to  be  entered  into  the  library 
under  the  name  supplied  in  the  "cpu-id"  field.  If  the 
CAT  option  is  selected,  the  CPU-END  statement  may  not 
be  omitted. 

NCAT 

The  NCAT  option  specifies  that  the  desired 
CPU  definition  will  be  found  on  the  next  tv;o  cards, 
types  01  and  02  (see  appendix  A).  However ,  the  CPU 
definition  will  be  used  for  the  current  simulation 
only,  and  will  not  be  entered  into  the  library.  If 
the  NCAT  option  is  selected,  the  CPU-END  statement  may 


not  be  omitted. 


Memory  Definitions 


The  memory  definition  statement  is  used  to 
supply  the  simulator  wiith  a  description  of  the  memory 
module  or  modules  which  are  to  be  used  for  this  run. 


STATEMENT  FORMAT 


NOT  USED 

OP-CD 

OPERANDS 

MEM-DEF 

mem-id  ( ,LIB ,CAT ,NCAT) 

(memory  hardware  definition  card  type  03,  see  appendix  A) 
MEM-END 

mem- id 

The  "mem-id"  field  must  contain  the  name 
(limited  to  6  characters)  by  which  this  memory  defin¬ 
ition  will  be  referenced  by  the  configuration  data. 

The  use  of  this  field  is  governed  by  the  option  chosen 
for  the  following  field. 

LIB 

The  LIB  option  sped  ties  that  the  desired 
memory  definition  may  be  found  in  the  system  library 


4 


eoid  that  the  memory  definition  card,  type  03  is  not 
included  in  the  input  stream.  The  Memory  Definition 
in  the  library  must  have  the  sajne  name  as  the  "mem-id" 
field.  If  the  LIB  option  is  selected  the  MEM-END 
statement  must  be  omitted. 

CAT 

The  CAT  option  specifies  that  the  desired 
Memory  definition  will  be  found  on  the  next  card, 
type  03  (see  appendix  A).  In  addition,  this  option 
will  cause  the  Memory  Definition  to  be  entered  into 
the  library  under  the  name  supplied  in  the  "mem-id" 
field.  If  the  CAT  option  is  selected,  the  MEM-END 
statement  may  not  be  omitted. 

NCAT 

The  NCAT  option  specifies  that  the  desired 
Memory  definition  will  be  found  on  the  next  card,  type 
03  (see  appendix  A).  ll'.nvever,  xhe  Meriery  definition 
will  be  used  for  the  current  .-simulation  only  and  will 
not  be  entered  into  the  library.  If  the  NCAT  option 
is  selected,  the  MEM-END  statement  may  not  be  omitted. 
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Channel  Definitions 

The  channel  definition  statement  is  used  to 
supply  the  simulator  with  a  description  of  the  channel 
or  channels  which  are  to  be  used  for  this  run. 


STATEMENT  FORMAT 


NOT  USED 

OP-CD 

0PER/\NDS 

CEAN-DEF 

chan-id  ( ,LIB ,CAT ,NCAT) 

[ 

(channel  hardware  definition  card  type  04,  see  appendix  A) 

CHAN -END 

CHAN-ID 

The  CHAN-ID  field  must  contain  the  name 


(limited  to  6  characters)  by  which  this  channel  defin¬ 
ition  will  be  referenced  by  the  configuration  data. 

The  use  of  this  field  is  governed  by  the  option  for 
the  following  field. 

LIB 

The  LIB  option  specifies  that  the  desired 
channel  definition  may  be  found  in  the  system  library 
and  that  the  chsuincl  definition  card,  type  04  is  not 
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included.  The  channel  definition  in  the  library  must 
have  the  same  name  as  the  field  "chan-id".  If  the  LIB 
option  is  selected,  the  CHAN-END  statement  must  be 
omit  ted. 

CAT 

The  CAT  option  specifies  that  the  desired 
channel  definition  will  be  found  on  the  next  card,  type 
04  (see  appendix  A).  In  addition,  this  option  will 
cause  the  channel  definition  to  be  entered  into  the 
library  under  the  name  supplied  in  the  "chan-id"  field. 
If  the  CAT  option  is  selected,  the  CHAN-END  statement 
may  not  be  omitted. 

NCAT 

The  NCAT  option  specifies  that  the  desired 
channel  definition  will  be  found  on  the  next  card,  type 
C4  (see  appendix  A).  However,  the  channel  definition 
will  be  used  for  the  current  sir.alation  only,  and  will 
not  be  entered  into  li'.e  libr.o'y.  If  the  NCAT  option  is 
selected,  the  CliAN-E.\D  state";ent  ::;ay  not  be  omitted. 
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Device  Definitions 


The  device  definition  statement  is  used  to 


supply  the  simulator  ivith  a  description  of  the  device 
or  devices  which  are  to  be  used  for  this  run. 


STATE>:ENT  FORMAT 

NOT  USED 

OP-CD 

OPERANDS 

DEV-DEF 

dev-name  ( ,LIB,CAT,NCAT) 

(device  hardware  definition  card  type  05,  appendix  A) 

DEV- END 

dev-id 

The  "dev-id"  field  must  contain  the  name 


(limited  to  6  characters)  by  which  this  device  defin¬ 
ition  will  be  referenced  by  the  configuration  data. 

The  use  of  this  field  is  governed  by  the  option  chosen 
for  the  following  fields. 

LIB 

The  LIB  option  spvciiies  that  the  desired 
device  definition  may  be  toun-.i  in  the  system  library 
an’.',  that  the  device  definition  card,  ty'pe  05  is  not 
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included.  The  device  del'inition  in  the  library  must 
have  the  same  name  as  the  field  "dev-id".  If  the 
LIB  option  is  selected,  the  DEV-END  statement  must  be 
omitted. 

CAT 

The  CAT  option  specifies  that  the  desired 
device  definition  will  be  found  on  the  next  card,  type 
05  (see  appendix  A).  In  addition,  this  option  will 
cause  the  device  definitions  to  be  entered  into  the 
library  under  the  name  supplied  in  the  "dev-id"  field. 
If  the  CAT  option  is  selected,  the  DEV-END  statement 
may  not  be  omitted. 

NCAT 

The  NCAT  option  specifies  that  the  desired 
device  definition  will  be  found  on  the  next  card,  type 
05  (see  appendix  A).  However,  the  device  definition 
will  be  used  for  the  curren'v,  simulation  only,  and  will 
not  be  entered  into  ti^e  library.  If  the  NCAT  option  is 
selected,  the  DEV-END  statement  may  not  be  omitted. 
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Configuration  Data 

The  Configuration  Data  supplied  to  the  sim¬ 
ulator  specifies  the  organization  of  the  hardware  data 
which  has  already  been  defined.  For  example,  the  CPU 
statement  shown  below  is  used  to  specify  che  number  of 
CPUs  to  be  used  in  the  current  simulation.  If  there 
are  to  be  two  CPUs  in  the  system  then  there  must  be 
two  CPU  statements.  On  the  other  hand,  if  both  CPUs 
are  identical,  only  one  CPU-DEF  statement  was  needed. 


LO 


CONFIGURATION  DATA 


STATEMENT  FORMAT 


NOT  USED 

OP-CD 

OPERANDS 

CONFIG 

( config-naiKG)  (, LIB, CAT) 

CPU 

cpu-name,  cpu-id 

laem-naiRe ,  inem-id,  cpu-najie 


HANNEL 


chan-narae ,  chan-id,  cpu-name  ,  .  . 


ONTROL 


( IN  ,OUT ,  I/O)  ,  ctl-n£U!ie  ,  chan-name  , 


DEVICE 


( SEIZE  jNOSEIZE)  ,  dev-r^oie,  dev-id, 


C"tx— HiXiTjO  •  •  • 


:ONFIG-END 


CONFIG 


The  CONFIG  statement  indicates  the  beginning 
of  the  Configuration  Data. 
conf ig-name 

The  ’'conf ig-name”  field  is  required,  only  if 
The  Configuration  Data  is  in  the  library,  or  is  to  be 
placed  in  the  library.  The  usage  of  this  field  is 
defined  by  the  option  selected  for  the  next  field. 

If  the  configuration  data  is  neither  in  the 
library,  nor  to  be  placed  in  the  library  (NCAT  option) 
no  operands  should  be  specified. 

LIB 

The  LIB  option  specifies  that  the  desired 
Configuration  Data  may  be  found  in  the  system  library 
and  that  the  configuration  data  will  not  be  found  in 
the  inpuv  stream.  If  the  LIB  option  is  specified,  the 
CONFIG-END  statement  rty  not  appear. 

CAT 

The  CAT  option  specifies  that  the  desired  Con 
figuration  Data  is  to  be  placed  into  the  system  library 
The  Configuration  Data  must  appear  in  the  input  stream 
and  the  CONFIG-END  statement  may  not  be  omitted. 


The  CPU  statement  is  used  to  specify  the 
number  and  names  of  the  CPUs  required  for  the  current 
simulation.  There  must  be  one  CPU  statement  for  each 
CPU  in  the  system. 
epu-name 

The  "epu-name"  field  must  contain  the  name 
by  which  this  CPU  will  be  referenced  during  this  sim¬ 
ulation.  CPUs  are  numbered  in  the  order  of  their  CPU 
statements. 
epu-id 

The  "epu-id"  field  must  contain  the  naune 


(limited  to  6  characters)  of  the  CPU  Definition  which 
provides  the  operating  characteristics  of  this  CPU. 
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MEM 


The  MEM  statement  is  used  to  specify  the 
number  and  names  of  the  memories  required  for  the 
current  simulation.  There  must  be  one  MEM  statement 
for  each  memory  in  the  system. 
mem -name 

The  "mem-name"  field  must  contain  the  name 
by  which  this  memory  will  be  referenced  during  this 
simulation.  Memories  are  numbered  in  the  order  of 
their  MEM  statements, 
mem-id 

The  "mem-id"  field  roust  contain  the  name 
(limited  to  6  characters)  of  th<^  Memory  Definition 
which  provides  the  operating  characteristics  of  this 
memory  module. 
cpu-name 

The  "cpu-name"  fields,  up  to  five,  must 
contain  the  name  of  each  CPU,  as  provided  in  the  CPU 
statement,  to  which  this  memory  is  connected. 
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CHANNEL 


The  CHANNEL  iJtatement  is  used  to  specify  the 
number  and  names  of  the  channels  required  for  the  current 
simulation.  There  must  be  one  CHANNEL  statement  for 
each  channel  in  the  system. 
chan-name 

The  "chan-naime"  field  must  contain  the  name 
by  which  this  channel  will  be  referenced  during  this 
simulation.  Channels  are  numbered  in  the  order  of  their 
CHANNEL  statement. 
chan-id 

The  "chan-id"  field  must  contain  the  neime 
(limited  to  6  characters)  of  the  Channel  Definition 
which  provides  the  operating  characteristics  of  this 
channel . 
cpu-ncime 

The  "cpu-name"  fields,  up  to  five,  must 
contain  the  name  of  each  CPU,  as  provided  in  the  CPU 
statement,  to  which  this  channel  is  connected. 
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CONTROL 


The  CONTROL  statement  is  used  to  specify  the 
number  and  names  of  the  control  units  required  for  the 
current  simulation.  There  must  be  one  CONTROL  statement 
for  each  control  unit  in  the  system. 

IN 

The  IN  operand  specifies  that  this  control 
unit  is  an  input  unit  only. 

OUT 

Tne  OUT  operand  specifies  that  this  control 
unit  is  an  output  unit  only. 

I/O 

The  I/O  opera. id  specifies  that  this  control 
unit  is  capable  of  performing  both  input  and  output 
operati  ns . 

The  "ctl-najne"  field  must  contain  the  naime 
by  which  this  control  unit  will  be  referenced  during 
this  simulation.  Control  units  are  numberefi  in  the 


order  of  their  CONTROL  statements. 
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chan-name 

The  "chan-name"  field  must  contain  the  name 
of  each  channel,  as  provided  in  the  CHANNEL  statement, 
to  which  this  control  unit  is  connected. 


% 


DEVICE 


The  DEVICE  statement  is  used  to  specify  the 
number  and  names  of  the  devices  required  for  the 
current  simulation.  There  must  be  one  DEVICE  state¬ 
ment  for  each  device  in  the  system. 

SEIZE 

The  SEIZE  operand  specifies  that  this  device 
may  be  seized  by  individual  worker  routines  during  the 
course  of  the  simulation. 

NOSEIZE 

The  NOSEIZE  operand  specifies  that  this 
device  may  not  be  seized  by  worker  routines  during  this 
simulation. 
dev-name 

The  "dev-name"  field  must  contain  the  name 
by  which  this  device  will  be  referenced  during  this 


simulation. 
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dev-id 

The  "dev-id"  field  must  contain  the  name 
(limited  to  6  characters)  of  the  Device  Definition 
which  provides  the  operating  characteristics  of  the 
device . 
ctl-naone 

The  "ctl-name"  field  must  contain  the  naime 
of  the  control  unit,  as  provided  in  the  CONTROL,  state 
ment  to  wJiich  this  control  unit  is  connected. 
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TO-FROM  Table  Definition 


The  TO-FROM  table  is  used  to  specify  the 
amouTit  of  time  required  to  move  a  random  access  device 
arm  from  one  file  to  another.  When  files  are  assigned 
to  random  access  units,  they  have  relative  locations 
on  the  device  from  1  to  the  total  number  of  files  on  the 
device.  The  user  nay  then  define  the  amount  of  time 
r  quired  to  move  from  one  file  to  another,  or  the  average 
time  required  to  move  from  one  record  in  a  file  to 
another  record  in  the  sajiie  file. 


1  STATEMENT  F'ORM/M 

NOT  USED 

OP -CD 

OPERANDS 

TF-DEF 

dt v-namc ,  #~files 

TAELE 

Ml,  M2,  M3 

TAHLE 

N:;i,  N22,  N23 

T/\iUJ' 

N31,  N32.  \>3 

TF-END 
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dev-name 

The  "dev-name"  field  must  contain  the  name  of 
the  device  to  which  the  current  TO -FROM  definition 
applies.  This  name  must  be  the  same  as  the  name  supplied 
for  the  device  in  the  configuration  data. 

#-f iles 

The  "#-files"  field  must  contain  the  number 
of  files  which  are  assigned  to  the  device. 

TABLE 

Each  row  in  the  TO-FROM  table  must  begin  with 
the  operation  code  "TABLE". 

N  11 

The  "N  11"  operand  must  contain  the  aciiount 
of  time  in  milliseconds  required  to  get  from  file  1 
to  file  1  on  the  current  device.  Each  operand  must 
have  a  maximum  of  5  decimal  digits. 

X  12 

The  "N  12"  operand  must  contain  the  cxmount 
of  time  in  milliseconds  required  to  get  from  file  1 
to  file  2  on  the  current  device. 
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The  sample  TO-FROM  table  illustrated  above 
provides  the  required  information  for  a  device  with  3 
files.  A  TO-FROM  table  may  be  constructed  for  a 
device  with  up  to  13  files. 


QUEUE  Deiinition 


The  QUEUE  definition  statement  is  used  to 
supply  the  simulator  with  descriptions  of  the  queues 
which  will  be  used  during  the  current  simulation. 


STATEMENT  FORMAT 

- 1 

LABEL 

OP -CD 

OPERANDS 

Q-DEF 


QUEUE 


q-name,  entries  (, AT , lOT) (, FIFO , LIFO ,?RI ) 


Q-END 


a -name 


The  "q-name"  field  must  contain  the  name  by 
which  this  queue  will  be  referenced  during  the  current 
simulation. 
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entries 

The  "entries"  field  must  contain  a  1  to  4 
decimal  digit  number  specifying  the  maocimum  number  of 
entries  which  this  queue  will  be  permitted  to  contain. 

If  the  AT  operand  is  specified,  the  queue 
being  defined  may  not  contain  I/O  transaction  items. 
lOT 

If  the  lOT  operand  is  specified,  the  queue 
being  defined  may  not  contain  available  transactions. 

AT  aoid  lOT  may  not  be  specified  for  the  same  queue. 

FIFO 

If  the  FIFO  operand  is  specified,  the  queue 
being  defined  will  be  organized  as  a  first  in,  first 
out  queue . 

LIFO 

If  the  LIFO  operand  is  specified,  the  queue 
being  defined  will  be  orgaoiized  as  a  l\st  in,  first 
out  queue. 

PRI 

If  the  PRI  operand  is  specified,  the  queue  being 
defined  will  be  organized  in  priority  sequence. 
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REAL  FILE  Descriptions 


The  REAL  FILE  statement  describes  the  real 
files  which  will  be  used  during  this  simulation. 


STATEMENT  FORMAT 

LAEFL 

OF-CD 

OPERANDS 

FILE-DEF 

RF 

file -name ,dev-name ,re3 -loc ,buf f-len , rec/buff , buff /file 

• 

RFC 

old-file-name ,new-file-name( ,dev-name) { ,rel-loc) 

• 

FILE-END 

_ 

file-name 

The  "file-name"  field  must  contain  the  name 
by  which  this  real  file  will  be  referenced  by  ORDINAL 


FILE  statements 
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dev-naiine 

The  "dev-name"  field  must  contain  the  naime  of 
the  device  on  which  this  file  resides. 
rel"loc 

The  "rel-loc"  field  must  contain  the  relative 
location  of  this  file  on  the  device  specified  if  there 
is  more  than  one  file  on  that  device. 
buff -len 

The  "buff -len"  field  must  contain  the  length 
of  the  buffer,  in  character required  to  hold  a 
physical  record  from  this  file. 
rec/buff 

The  "rec/buff"  field  must  contain  the  number 
of  logical  records  contained  in  one  physical  record 
from  this  file. 
buff/f ile 

The  "buff/file"  field  must  contain  the  number 
of  physical  records  contained  in  this  file,  i.e.,  file 
size . 


u'.rt  , 
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REAL  FILE  COPY 


In  order  to  assist  the  user  in  describing  a 
large  number  of  files  whose  physical  characteristics 
are  identical,  provision  is  made  for  copying  the 
physical  characteristics  of  a  file  already  described, 
and  giving  the  file  a  new  name,  device  assignment  and 
relative  location.  To  perform  this  operation,  the  RFC 
statement  is  supplied. 
old-file-name 

The  "old-file -name"  field  must  contain  the 
name  of  a  file  previously  described  by  meeuis  of  a  RF 
statement.  All  physical  information  is  copied  from  that 
file’s  description. 
new-file-name 

The  "new-f ile-ncune"  field  must  contain  the  name 
by  which  this  copied  file  description  is  to  be  known. 
dev-name 

If  the  "new-file"  is  to  reside  on  a  different 
device  from  the  "old-file",  the  "dev-name"  field  must 


contain  the  name  of  this  device. 
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rcl-Ioc 

If  the  "new-file"  is  to  have  a  different 
relative  location  from  the  "old-file",  the  "rel-loc" 
field  must  contain  new  relative  locations. 
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LOAD  CLASS 


The  LOAD  CLASS  statement  allows  the  user  to 
specify  combinations  of  CPUs  which  are  able  to  load 
programs  for  the  system  being  simulated.  For  example, 
if  program  A  can  be  loaded  by  CPUs  1  and  2,  but  program 
B  may  only  be  loaded  by  CPU2,  then  a  load  class  of  CPUs 
1  and  2  and  another  load  class  consisting  of  CPU2  only 
must  be  defined.  Program  A  would  then  be  defined  as 
being  in  load  class  1  while  program  B  is  in  load  class  2. 


!  STATEMENT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

LC-DEF 

LOAD 

class-#,  cpu-name  (,cpu-namo) 

LC-END 

class-# 

The  ’’class-#”  must  be  a  unique  number  from 


\ 


1  to  15 


cpu-naime 


For  each  load  class  entry  each  of  the  CPUs 
in  that  entry  must  be  named. 

NOTE:  If  the  current  simulation  uses  only 

one  CPU  then  the  LOAD  CLASS  entry  may  be  omitted. 
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RUN  CLASS 


The  RUN  CLASS  statement  allows  the  user  to 
specify  which  CPU  or  CPUs  may  execute  a  program  based 
upon  the  CPU  which  performed  the  load  function.  For 
example,  in  a  system  where  there  are  two  CPUs  and  a 
single  memory  shared  by  both  of  them,  then  auny  program 
loaded  by  either  CPU  may  be  executed  by  either  CPU. 
However,  if  the  two  CPUs  each  had  their  own  memory, 
although  a  program  could  be  loaded  by  either  CPU,  it 
could  only  be  executed  by  the  CPU  which  loaded  it. 


STATEMENT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

RC-DEF 

RUN 

loading-cpu -name , cpu-name  ( ,cpu-namo ) 

• 

• 

RC-END 
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load-cpu 

The  "load-cpu"  field  must  contain  the  name 
of  the  CPU  for  which  a  RUN  CLASS  is  being  described. 

If  there  is  more  than  one  CPU  in  the  current  simulation, 
there  must  be  one  RUN  statement  for  each  CPU. 
cpu-name 

The  "cpu-name"  fielc,  must  contain  the  name  of 
each  CPU  capable  of  executing  a  program  loaded  by  the 
CPU  specified  in  the  "load-cpu"  field. 

NOTEi  If  the  current  simulation  uses  only 
one  CPU  then  the  RUN  CLASS  statement  may  be  omitted. 


The  TABLE  PRINT.  >UT  CONTROL  statement  is  used 


to  specify  which  tables  are  to  be  printed  at  the  end  of 
each  statistical  interval. 


STATEMENT  FORMAT 


LABEL 

OP-CD 

OPERANDS 

TAB-CTL 

(0N,0FF)(,T1)(,T2)(,  .  .  .  ) 

ON 

If  the  ON  operand  is  specified,  the  normal 


condition  for  each  table  switch  will  be  ON.  Those 
tables  which  are  not  to  be  printed  may  be  specified  in 
subsequent  operands. 

OFF 

If  the  OFF  operand  is  specified,  the  normal 
condition  for  each  table  switch  will  be  OFF.  Those 
tables  which  are  to  be  printed  may  be  specified  in 


subsequent  operands. 
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TABLE  XU>3ER 

T1 

T2 

T3 

T4 

T5 

T6 

X  t 

T8 

T9 

710 

T12 

713 

714 

715 

716 

717 

718 

719 

720 

721 

722 

723 

724 


7A3LE  :.A>S 
FU7VRE  E\7L27rS  CHAIN 
C^C  I7E-M 
TRANSAcnox  ite:^ 

I 'O  TRANSACTION  ITEM 
>X)i&:ER  ROUTINE  BASE 
FILE  SECTOR 
>E>:ORY 

PAvjc- 

LOAP  CLASS 
RUN  CLAs> 

(QUEUE 

QUEUE  e>t:ry 

k* 

.\v.Ari.A3xi^i7Y 

CHA?;XEL 

COX i nOL 

OFVICE  CLASS 

O  *^X  w  .-cAL  S  i.  Lr AT  IQX 

FLACTIOX 

^  i  A  i  c-McNT 

SWI7CM 

rO-FROM 


725 


VARK  TIME 
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STATISTICS  PRINTOUT  CONTROL 

The  STATISTICS  PRINTOUT  CONTROL  stateraent  is 
used  to  specify  which  sets  of  statistics  are  to  be 
prirtec  at  the  end  of  each  statistical  interval. 

Lv^NT  FORMAT 

I  I 

j  Or -CD  I OPERANDS 

j 

STAT-CTL  I (ON ,Or r ) ( STi) ( , ST2) ( ,  .  .  .  ) 

_ l _ 

ON 

If  the  ON  operand  is  specified,  the  noraaCL 
condition  will  be  for  ail  statistics  to  be  printed. 
Those  statistics  which  are  not  to  be  printed  nay  be 
specified  in  subsequent  operands. 

OFF 

If  the  OFF  operand  is  specified,  the  noriaal 
ccndition  '..ill  be  for  no  statistics  to  be  printed. 
Those  statistics  which  to  be  printed  nay  be  spec¬ 

ific  I  in  subsequ'^nt  operands. 
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STATISTICS  NUNSER 

STATISTICS  NA>?E 

STl 

QUEUE 

ST2 

ME>50RY 

ST3 

FILE 

ST4 

DE\TCE 

STS 

CONTROL  UNIT 

ST6 

CHANNEL 

ST7 

CPU 

STS 

QUEUE  ANALYSIS 

STAT 

K/R 

STATISTICS  IXTERVAi-  CONTROL 


The  STATISTICS  INTERVAL  CONTRCL  statement  is 


used  to  control  the  interval  between  printing  of 
statistics  and  the  number  of  such  intervals  which 
are  to  be  simulated. 


1  STATEMENT  FOR>LAT 

LABEL 

OP-CD 

OPERANDS 

^ . . 

STATISTICS 

minutes , count 

luXTi'U't^  S 

The  "minutes"  field  must  contain  the  number 


of  minutes  in  a  single  simulation  interval. 
count 

The  "count"  field  must  contain  the  total 
nunber  of  intervals  to  be  simulated. 


GLOBAL  EQUATE 


The  GLC®AL  EQUATE  stateiuent  assigns  a  value 
to  a  label  vfhich  ivill  be  recognized  in  any  routine 
assecbled  during  the  current  simulation.  All  global 
equate  statements  must  appear  before  the  first  job 
statement. 


STATEMENT  FOR>A' 


LABEL 

OP -CD 

OPERANDS 

symbol 

GEQU 

T’alue 

Tno  "symbol"  field  must  begin  with  cui  alpha¬ 
betic  character  and  must  be  limited  to  12  or  less  char¬ 
acters.  When  this  symbol  appears  in  any  other  statement 
it  will  be  replaced  with  the  value  specified  as  the 
operand  for  this  statement. 
value 

The  "value"  field  must  contain  a  numeric  value 
of  4  or  less  decimal  digits.  This  is  the  value  which 


will  be  used  to  replace  the  symbol  described  above. 
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LOCAL  EQUATE 


The  LOCAL  EQUATE  statement  assigns  a  value 
to  a  label  which  will  be  recognized  only  in  the  routine 
currently  being  assembled.  A  local  equate  statement 
must  appecir  after  the  JOB  statement  atnd  before  the  END 
statement  of  the  routine  in  which  it  is  to  be  used. 


STATEMENT  F02M4T 

LABEL 

OP -CD 

OPERANDS 

synibol 

LEQU 

value 

_ 

SA/mbol 

The  "symbol"  field  must  begin  with  an  alpha¬ 


betic  character  and  is  limited  to  12  or  less  characters. 
When  this  symbol  appears  in  auiy  other  statement  of  the 
current  routine,  it  will  be  replaced  with  the  value 
specified  in  the  operand  of  this  statement. 
value 

The  "value"  field  must  contain  a  numeric  value 


of  4  or  less  decimal  digits. 
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JOB 


The  JOB  statement  defines  a  worker  routine. 


In  addition,  it  provides  the  simulator  with  certain 
information  about  the  worker  routine. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS  I 

JOB 

job-name,  (OS, PW,BUS,SCI ) ,  (REENT,NREENT)  j 

job-naone 

The  "job -name"  field  must  contain  the  unique 


naone  of  the  current  JOB. 

OS 

The  OS  operand  informs  the  simulator  that  the 
current  JOB  is  an  operating  system. 

PW 

The  PW  operaoid  informs  the  simulator  that  the 
current  JOB  is  a  primary  worker. 

BUS 

The  BUS  operand  informs  the  simulator  that  the 
current  JOB  is  a  commercial  worker  routine. 


The  SCI  operand  informs  the  simulator  that  the 


current  JOB  is  a  scientific  worker  routine. 
kEENT 


The  IvEEWT  operand  informs  the  simulator  that 
the  current  JOB  is  reentrant. 

NREENT 


The  NREENT  operand  informs  the  simulator  that 


the  current  JOB  is  not  reentrant . 


ORDINAL  FILE 


The  ORDINAL  FILE  stateir._*nt  describes  the  files 


to  be  used  by  the  current  JOB.  In  addition,  it  describes 
which  files  and  devices  must  be  seized  before  the  current 
JOB  can  be  executed. 


STATEMENT  FORMAT  | 

LABEL 

OP-CD 

OPERANDS 

OF 

of -name,  rf-name,  buff -no, 
mOFEIZE.  SEIZE-DEV.  SEIZE-FILE^ 

of -name 

The  "of-narae"  field  specifies  the  naune  by  which 
the  file  is  referenced  within  the  current  JOB. 
rf -name 

The  "rf-najne"  field  specifies  the  naime  of  the 
real  file  which  is  to  be  used  when  the  OF-NAME  is  refer¬ 
enced. 
buff -no 

The  "buff -no"  field  must  contain  the  number 
of  buffers  which  are  to  be  allocated  for  use  by  the  file. 
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NOSEIZE 

The  NOSEIZE  operand  specifies  that  neither 
the  file  nor  the  device  mu't  be  seized  for  I/O  oper¬ 
ation  referencing  this  file. 

SEIZE -DEV 

The  SEIZE-DEV  operand  specifies  that  the 
device  on  which  the  file  resides  must  be  seized  before 
this  JOB  may  begin. 

SEIZE-FILE 

The  SEIZE-FILE  operand  specifies  that  this 
file  must  be  seized  before  the  JOB  may  being. 
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MEMORY-]. 


The  MEMORy-1  statement  provides  the  user  with 
a  simple  method  for  describing  the  amount  of  memory 
which  will  be  required  to  run  the  current  JOB, 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS 

MEM-1 

inst,  char 

inst 

The  "inst"  field  specifies  the  number  of 


instructions  required  for  the  current  JOB,  This  operand 

must  be  in  the  format  DDDE, 

char 

The  "char"  field  specifies  the  number  of 
characters  of  storage  required  for  the  current  JOB, 

This  operand  must  be  in  the  format  DDDE, 

Format  DDDE  is  interpreted  as  a  number  in 
the  range  from  1  to  999  with  an  exponent  in  the  ranee 


from  0  to  9 
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MEMORY-2 


The  MEMORY-2  statement  provides  the  user 
with  a  detailed  mechanism  for  describing  the  amoun ^  of 
data  storage  required  by  the  current  JOB. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS 

MEM-2 

dec-field,  dec-len,  bin-fields,  bin-len, 

float-fields,  float-len 

dec-fields 

The  "dec -fields"  field  must  contain  the  number 
of  decimal  fields  required  by  the  current  JOB, 
dec-len 

The  "dec-len"  field  must  contain  the  length,  in 
decimal  digits,  of  the  dec-fields. 
bin-fields 

The  "bin-fields"  field  must  contain  the  number 
of  binary  fields  required  by  the  current  JOB. 


(T 


45 


bin-len 

The  "bin-len”  field  must  contain  the  length, 
in  decimal  digits  of  the  "bin-fields"  field. 
float-fields 

The  'float-fields"  field  must  contain  the  number 

$ 

of  floating-point  fields  required  by  the  current  JOB. 
float-len 

The  "float-len"  field  must  contain  the  length, 
in  decimal  digits,  of  the  "float -fields"  field. 


GENERATE 


The  (^NERATE  statement  allows-  t  ie  user  to 


specify  the  frequency  aind  total  number  of  transactions 
which  are  to  be  generated  for  the  current  JOB. 


LABEL 

OP-CD 

GEN 

interval,  (FIX.POISS),  limit,  priority 

interval 

The  "interval"  field  specifies  the  interval 
in  seconds  between  the  generation  of  transactions  for 
the  JOB.  This  operand  must  be  in  the  formal  DDDE. 

Format  DDDE  is  interpreted  as  a  number  in  the 
range  from  1  to  999  with  am  exponent  in  the  ramge  from 
0  to  99. 

FIX 

The  FIX  operand  specifies  that  the  interval 
between  the  generation  of  transactions  for  this  JOB  is 
to  be  considered  as  a  fixed  value. 
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POISS 


The  PGISS  operand  specifies  that  the  interval 
between  the  generation  of  transactions  for  this  JOB  is 
to  be  modified  by  a  poisson  distribution.  This  enables 
the  user  to  vary  the  interval  of  generation, 
limit 


The  "limit"  field  must  contain  the  total  nvunber 
of  transactions  which  are  to  be  generated  for  this  JOB. 
priority 


The  "priority"  fisld  must  contain  the  priority 
which  is  to  be  associated  with  this  JOB,  The  priority 
must  be  in  the  range  of  1  to  99  with  1  as  the  highest 
priority  and  99  the  lowest. 


TRANSFER 


The  TRANSFER  statement  allows  the  user  to 
alter  the  normal  sequence  of  statements  to  be  executed 
by  the  simulator.  Normally,  statements  are  executed 
sequentially  one  right  after  another.  Eac^:  time  a 
statement  is  executed,  the  next  sequential  instruction 
counter  (NSI)  is  incremented  to  the  address  of  the 
next  statement  to  be  executed.  When  a  TRANSFER  state¬ 
ment  is  executed,  the  NSI  is  replaced  with  the  address 
of  the  statement  specified  by  LOC. 


STATEMENT  FORMAT 

LABEL 

OP -CD  . 

OPERANDS 

TRA 

_ _ _ 

loc 

Iqc 

The  ’’loc"  field  must  contain  the  label  of  the  next 


statement  to  be  executed 
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TRANSFER  ON  PROBABILITY 

The  TRANSFER  ON  PROBABILITY  statement  is  much 
lik >  the  TRANSFER  statement.  However,  instead  of  auto¬ 
matically  changing  the  next  sequential  instruction 
counter  to  the  address  of  the  statement  specified  by 
LOG,  a  draw  is  first  made  from  a  pseudo-random  number 
generator.  Since  the  random  number  generator  provides 
numbers  in  the  range  from  0  to  99,  if  the  random  number 
provided  is  less  than  percentage  probability  of  transfer 
a  transfer  will  occur.  If  the  random  number  generated 
is  equal  to  or  greater  than  the  percentage  probability 
of  transfer  no  transfer  will  occur  and  the  next  sequential 
instruction  will  be  executed.  If  a  transfer  does  occur, 


the  next  statement  to  be  executed  will  be  found  at  the 
address  s  jecified  by  the  field  LOC. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS 

TRA-P 

PERCENT, LOC 

r 
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percent 

The  "percent"  field  must  contain  a  number 
within  the  zange  0  to  100.  This  field  specifies  the 
probability  of  making  a  transfer  to  the  address  speci¬ 
fied  by  LOG.  It  should  be  realized  that  if  the  percent 
field  is  set  equal  to  0  the  instruction  effectively 
acts  as  a  no-op.  If  the  percentage  probability  for 
transfer  is  equal  to  100  then  the  instruction  effectively 
acts  as  an  unconditional  transfer. 
loc 

The  "loc"  field  must  contain  the  label  of  the 
statement  to  be  executed  if  transfer  does  pccur. 


r 


\ 


RE.^D 


The  READ  statement  causes  the  simulator  to 
generate  an  interrupt  into  the  operating  system.  Th's 
means  that  the  current  operating  transaction  (COT) 
will  become  the  available  transaction  (AT)  and  an 
operating  system  transaction  will  be  generated  as  COT. 
The  next  sequential  instruction  counter  for  the  COT 
will  then  be  set  to  the  interrupt  address  specified 
for  the  READ  interrupt.  It  will  then  become  the 
responsibility  of  the  operating  system,  using  the 
statements  provided,  to  handle  the  input/output 
operation  requested. 


STAIEMENT  FORMAT 

LABEL 

OP -CD 

opera;-ds 

READ 

of -name 

of -name 


The  of -name  operand  specifies  the  name  of  the 
ordinal  file  for  which  this  READ  operation  is  to  occur. 
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It  is  important  to' note  that  there  must  be  an  ordinal 
file  card  for  every  ordinal  file  referenced  in  a 
worker  routine. 

When  this  statement  is  used  within  the 
operating  system,  the  READ  interrupt  must  be  enabled. 


% 
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WRITE 

The  WRITE  statement  causes  the  simulator  to 
generr a  VRITE  interrupt  into  the  operating  system. 
This  means  that  the  current  operating  transaction  (COT) 
will  become  the  available  transaction  (AT)  and  an 
operating  system  transaction  will  be  generated  as  COT. 
The  next  sequential  instruction  counter  for  the  COT 
will  then  be  set  to  the  interrupt  address  for  the 
WRITE  interrupt.  It  will  then  become  the  responsibility 
of  the  operating  system,  using  the  statements  provided, 
to  handle  the  I/O  operation  requested. 


STATEMENT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

.WRITE 

of -name 

of -name 

The  "of -name"  operand  specifies  the  name  of 


the  ordinal  file  for  which  this  WRITE  operation  is 
to  occur.  It  is  important  to  note  that  there  must 


be  an  ordinal  file  card  for  cv'ery  ordinal  file  refer¬ 
enced  within  a  worker  routine. 

When  this  statement  is  used  within  an 
operating  system  the  WRITE  interrupt  must  be  en- 
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FUNCTION 


The  FUNCTION  statement  causes  the  simulator 
to  generate  a  FUNCTION  interrupt  into  the  op>erating 
system.  This  mesms  that  the  current  operating  trans¬ 
action  (COT)  will  become  the  available  transaction  (AT) 
and  an  operating  system  transaction  item  will  be 
generated  as  the  new  current  operating  treuisaction 
(COT).  The  next  scc^vential  instruction  counter  for 
the  COT  will  then  be  set  to  the  interrupt  address  for 
the  FUNCTION  interrupt. 

However,  unlike  the  READ  or  WRITE  statements 
the  FUNCTION  statement  vjill  also  cause  the  immediate 
generation  of  an  J/0  transaction  item.  The  duration 
of  the  I/O  operation  which  may  be  initiated  by  the 
operating  system  as  a  result  of  the  FUNCTION  interrupt 
is  governed  by  the  entries  in  the  system  function  table 
Each  entry  in  the  system  function  table  specifies  the 
length  of  time  the  channel,  control  unit,  and  devi''*^ 
are  to  be  busy  with  this  I/O  operation. 
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STATEMENT  FORMAT  | 

LABEL 

OP -CD 

FUNCTN 

fno 

fno 

The  "  fno"  field  specifies  the  number  of  the 


entry  in  the  system  function  table  which  is  to  be 
referenced  fay  the  I/O  advance  statement  in  the  operating 
system.  Function  numb-rs  not  like  ordinal  files 

in  that  they  must  be  assigned  uniquely  across  all  worker 
routines  within  a  given  simulation.  For  this  reason, 
the  FUT.CTION  statement  is  not  considered  a  normal 
10  operation  and  should  be  used  only  for.  I/O. .operations 
which  cannot  oe  represented  using  READ  or  WRITE  state¬ 
ments. 

When  this  statement  is  used  within  an  operating 
system  the  FUNCTION  interrupt  must  be  enabled. 


END  OF  FILE 


The  END  OF  FILE  statement  allows  the  worker 
routine  to  check  fox  an  end  of  file  on  any  one  of  the 
ordinal  files  being  used.  The  simulator  keeps  a  count 
of  the  total  nvimber  of  I/O  operations  performed  on  each 
ordinal  file.  In  addition,  the  number  of  blocks  in 
each  file  may  be  specified  in  the  file  description 
system  parameter  card.  When  this  statement  is  execu'ced, 
a  comparison  is  made  between  the  block  count  for  the 
real  file  and  the  number  of  I/O  operations  perform^ i  on 
that  file  by  the  current  transaction.  If  the  number 
of  10  operations  performed  is  equal  to  the  number  of 
blocks  in  the 'file  being  referenced,  a  transfer  will 
be  made  to  the  address  in  the  "loc"  field  of  this 
statement.  Otherwise  the  next  sequential  instruction 
will  be  executed. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS 

EOF 

of -name ,  loc 
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file 

The  "file"  field  specifies  the  name  of  the 
ordinal  file  for  which  the  END  OF  FILE  test  is  to  be 
executed.  It  is  important  to  note  that  there  must  be 
an  ordinal  file  card  for  every  ordinal  file  referenced 
in  a  worker  routine. 
loc 

The  "loc"  field  must  contain  the  label  of  the 
statement  to  be  executed  if  an  end  of  file  condition  is 
found  to  exist. 

The  END  OF  FILE  statement  may  not  be  used  on 
a  file  which  has  been  opened  more  than  once  by  the  same 
transaction  item.. 


SUBROUTINE 


The  SUBROUTINE  statement  allows  the  user  to 
execute  any  segment  of  code  within  a  worker  routine 
as  a  closed  subroutine.  When  the  SUBROUTINE  statement 
is  encountered  the  next  sequential  instruction  counter 
(NSI)  is  stored  into  one  of  the  three  fields  provided 
in  the  transaction  item  for  this  purpose.  The  NSI 
is  then  set  equal  to  the  address  of  the  subroutine 
to  be  executed.  The  end  of  a  subroutine  is  indicated 
by  an  EXIT  statement  which  will  return  control  to  the 


statement  after  the  SUBROUTINE  statement. 


loc 


The  "loc"  field  must  contain  the  label  of 


the  first  statement  in  the  subroutine  to  be  executed 
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ERROR  CONDITIONS 

A  worker  routine  is  permitted  a  maximum  of 
three  nested  subroutine  calls  at  any  given  time.  If 
a  fourth  nested  subroutine  is  encou*itered  during  a 
simulation  an  appropriate  diagnostic  will  be  issued 


and  simulation  will  terminate 
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EXIT 

The  EXIT  statement  is  used  to  indicate  the 
end  of  a  subroutine.  When  an  EXIT  statement  is 
encountered  the  next  sequential  instruction  counter 
for  the  current  operating  transaction  will  be  set  equal 
to  the  statement  immediately  following  the  last  SUBROUTINE 
statement  executed. 


STATEMENT 

FORMAT 

LABEL 

OP -CD 

OPERANDS 

EXIT 

The  EXIT  statement  has  no  oper.aaids., 

ERROR  CONDITION 

If  an  EXIT  statement  is  encountered  when 


there  are  no  active  subroutines  for  the  current 
operating  transaction  an  appropriate  diagnostic 
will  be  issued  and  simulation  will  terminate. 


LOOP 


The  LOOP  statement  allows  the  user  to  execute 
a  segment  of  code  a  specified  number  of  times .  Once 
the  specified  segment  cf  code  has  been  executed  the 
number  of  times  specified,  the  LOOP  statement  will  be 
ignored  and  the  statement  following  the  LOOP  statement 
will  be  executed. 


STATEMENT 

FORMAT 

OP -CD 

OPERANDS 

LOOP 

count,  loc 

count 

The  "count"  field  specifies  the  number  of  times 
a  transfer  to  the  location  specified  in  the  "loc"  field 
should  occur. 
loc 

The  "loc"  field  must  contain  the  label  of  the 
first  statement  in  the  segment  of  code  to  be  executed 
repeatedly.  Each  time  the  LOOP  statement  is  executed 
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a  LOOP  counter  will  be  decremented  and  a  transfer  to 
the  statement  with  label  ”loc”  will  occur.  Once  the 
LOOP  counter  has  reached  0  the  statement  after  the 
LOOP  statement  will  be  executed  next.  Noramlly  the 
statement  with  label  "loc"  should  precede  the  LOOP 
statement . 

ERROR  COI4DITIONS 

A  worker  routine  is  permitted  a  maximum  of 
three  nested  loops  at  any  given  time.  If  a  fourth 
LOOP  statement  is  encountered  while  all  three  LOOP 
counters  contain  a  value,  an  appropriate  diagnostic 
will  be  issued  and  simulation  will  be  terminated. 
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MOVE 


The  MOVE  statement  allows  the  user  to 
represent  the  amount  of  time  required  to  perform 
a  MOVE  operation.  A  simulated  advance  time  will 
be  calculated  by  dividing  the  number  of  characters 
to  be  moved  by  the  number  of  characters  in  a  logical 
data  unit  and  multiplying  the  result  by  the  aonount  of 
tim  required  to  move  a  single  logical  data  unit. 


STATEMENT  FORMAT 

JJVBEL 

DPERANDS 

MOVE 

char 

char 

The  ."char"  field  specifies  the  number  of 
characters  to  be  moved  as  a  memory  to  memory  tramsfer 


of  data 


MOVE  AND  EDIT 


The  MOVE  AND  EDIT  statement  allows  the  user 
to  simulate  the  amount  of  time  required  to  perform 
a  MOVE  AND  EDIT  operation.  A  simulated  advance  time 
is  calculated  by  dividing  the  n.wiber  of  characters 
to  be  moved  and  edited  by  the  axaount  of  time  to  move 


and  edit  a  single  character. 


characters  to  be  moved  and  edited  within  a  memory  by 
this  MOVE  AND  EDIT  operation. 
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COMPUTE 


The  COMPUTE  instruction  allows  the  user  to 
represent  the  execution  of  a  specified  number  of 
instructions.  The  amount  of  time  required  to  execute 
the  number  of  instructions  specified  will  be  added 
to  the  total  CPU  time  used  by  the  current  operating 
transaction. 


STATEMENT  FORMAT  ' 

LABEL 

OP -CD 

OPERANDS 

COMPUT 

inst , (mark) 

inst 

The  "inst"  field  specifies  the  number  of 


instructions  to  be  simulated.  This  field  will  be 
raiiltiplied  by  the  average  instruction  ex«*cation  time 
to  develop  an  advance  time  for  this  operation.  The 
simulator  will  then  draw  a  random  entry  from  the 
Poisson  Distribution  table  and  multiply  this  entry 
times  the  advance  time  calculated. 


d 
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mark 

The  "mark"  field  allows  the  user  to  total 
all  advance  times  for  selected  compute  statements. 
This  field  must  contain  the  number  of  the  mark  time 
accumulator  into  which  the  advance  time  for  this 
statement  will  be  added. 


r 

Vw 


y 


r 
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MATH 


r 


The  MATH  statement  provides  the  ability  to 
represent  precisely  the  time  required  to  perform 
arithmetic  operations.  The  user  specifies  the  number 
of  ADD,  MULTIPLY,  and  DIVIDE  operations  to  be  rep¬ 
resented  by  this  MATH  statement.  The  simulator  then 
uses  the  add,  multiply,  and  divide  times  specified  in 
the  CPU  definition  to  calculate  the  advance  time 


required.  In  the  MATH  statement,  unlike  the  COMPUTE 
statement,  the  advance  time  computed  is  not  weighted 
by  a  Poisson  Distribution. 


STATEMENT 

FORMAT 

-LABEL 

OP -CD 

OPERANDS 

MATH 

add,  rauit,  div 

add 

The  "add"  field  specifies  the  number  of 
additions  or  subtractions  to  be  represented  by  this 


statement 
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mult 

The  "mult"  field  specifies  the  number  of 
multiply  operations  to  be  represented  by  this  state¬ 
ment  . 
div 

The  "div"  field  specifies  the  number  of 
divide  operations  to  be  represented  by  this  statement. 
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OPEN 

The  OPEN  statement  is  used  to  initialize  the 
buffer  and  record  counts  for  an  ordinal  file  before 
the  ordinal  file  is  used  for  other  I/O  operations. 

With  the  exception  of  the  operating  system  every  worker 
routine  must  OPEN  an  ordinal  file  before  it  may  be 
referenced  by  a  READ,  WRITE,  or  PRINT  statement.  The 
OPEN  statement  generates  an  immediate  OPEN  interrupt 
and  an  I/O  transaction  item.  If  the  OPEN  operation 
specified  is  for  an  input  file,  the  I/O  transaction 
item  will  represent  the  time  required  to  fill  all 
available  buffers  for  the  file.  If  the  OPEN  operation 
specified  is  for  an  output  file,  the  10  transaction 
item  will  require  no  time  to  execute  and  will  merely 
initialize  the  buffer  and  record  counts. 


STATEMENT  FORMAT 


LABEL 

OP -CD 

OPERANDS 

OPEN 

of -name,  ( INPUT , OUTPUT) 
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of -name 

The  "of -name"  field  specifies  the  ordinal 
file  name  of  the  file  which  is  to  be  opened. 

INPUT 

The  INPUT  operand  specifies  the  ordinal  file 
to  be  opened  is  an  input  file. 

OUTPUT 

The  OUTPUT  r*perand  specifies  the  ordinal  file 
to  be  opened  is  an  output  file. 


CLOSE 


The  CLOSE  statement  is  used  to  release 
devices  which  have  been  seizea  by  a  PERIPHERAL  state¬ 
ment.  In  addition,  for  tape  files  only,  the  CLOSE 
operation  may  be  used  to  initiate  a  rewind  operation 
which  will  keep  the  device  busy  for  the  amount  of  time 
required  to  complete  a  REWIND  operation,  as  specified 
in  the  device  definition. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS 

CLOSE 

of  -name  ,  (REWIND,  NOREWIND  ) 

of -name 

The  ’’of -name"  field  specifies  the  ordinal  file 
name  which  is  to  be  closed  by  this  statement. 

REWIND 

The  i  IWIND  operand  specifies  that  if  the  ordinal 
file  being  closed  resides  on  a  tap>e  unit,  a  rewind  oper¬ 
ation  is  to  be  pcrforned. 


or 
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NOREWIND 


The  NOREWIND  operand  specifies  that  even  if 
the  file  being  closed  resides  on  a  tape  device  no 
rewind  operation  is  to  be  performed. 


r 
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TERMINATE 


The  TERMINATE  statement  generates  an  immediate 
TERMINATE  interrupt  into  the  operating  system.  This 
interrupt  is  used  to  inform  the  operating  system  that 
a  transaction  item  has  completed  all  requirements.  I:- 
addition  the  TERMINATE  statement  may  create  a  new 
transaction  for  another  worker  routine.  This  facility 
is  useful  when  worker  routines  must  be  executed  in  a 
specific  sequence.  In  addition  to  being  the  last 
logical  statement  in  a  worker  routine,  the  TERMINATE 
statement  must  also  be  the  last  physical  statement. 

If  more  than  a  single  TERMINATE  statement  is 


required,  they  must  be  adjacent  and  must  be  the  last 
statements  in  the  worker  routine. 


STATEMENT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

TERM 

(job -name ) 

job -name 


The  "job-name"  field,  if  used,  specifies  the 
name  of  the  worker  routine  for  which  a  new  transaction 
will  be  generated  immediately.  This  allows  the  term¬ 
ination  of  one  worker  routine  transaction  to  trigger 
the  generation  of  a  transaction  for  another  worker 


routine 
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PRINT 


The  PRINT  statement  allows  the  user  to 
represent  the  time  required  for  a  printer  to  space 
one  or  more  lines  after  printing.  In  every  other 
respect  it  is  exactly  the  same  as  the  WRITE  state¬ 
ment  . 


STATEMENT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

PRINT 

of -name,  spaces 

of -name 

The  "of -name"  field  specifies  the  name  of  the 
ordinal  file  to  which  this  PRINT  operation  is  directed. 
spaces 

The  "spaces"  field  specifies  the  number  of 
space  operations  to  be  performed  after  the  PRINT  is 
complete.  The  number  supplied  for  this  op>erand  is 
multiplied  by  the  amount  oi  time  required  to  perform 
a  single  space  and  the  total  time  calculated  is  added 
to  the  amount  of  time  the  device  on  which  this  ordinal 
file  resides, will  be  busy. 


CALL 


The  CALL  statement  provides  the  ability  to 
inform  the  operating  system  that  another  worker  routine's 
execution  is  required  by  the  current  operating  trans¬ 
action.  This  statement  stores  the  called  worker 
routine's  name  and  generates  an  immediate  interrupt 
into  the  operating  system.  This  statement  also  allows 
the  user  to  specify  whether  the  current  job  is  to  be 
deferred  until  the  newly  called  job  is  complete  or 


whether  the  current  job  may  continue  processing  with 
the  newly  created  job. 


STATEMENT  FORMAT  | 

LABEL 

OP -CD 

OPERANDS 

CALL 

job-name,  (DLY,NODLY) 

job -name 


The  "job-name"  field  specifics  the  name  of  the 
worker  routine  to  be  called  by  this  statement. 


The  DLY  operand  specifies  the  current  operating 
transaction  is  to  be  deferred  until  the  newly  called 
worker  routine  has  been  completed. 

NQDLY 

The  NODLY  operand  specifies  that  the  current 
operating  transaction  is  not  to  be  deferred  until  the 
newly  created  transaction  is  complete  but  rather  that 
the  current  transaction  may  compete  with  the  newly 
created  transaction  item  for  control  of  the  CPU. 
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EXEC 

»  - - 


The  EXEC  statement  provides  the  ability  to 
generate  an  interrupt  into  the  operating  system  for 
the  current  CPU.  Although  the  user  may  sp'^cify  the 
generation  of  any  one  of  the  twenty  interrupts  avail¬ 
able  to  its  CPU,  the  generation  of  an  open-close 
interrupt  for  example  will  not  cause  the  creation  of 
an  I/O  transaction  item.  Therefore,  if  the  operating 
system  requires  an  I/O  transaction  item  for  some  inter¬ 
rupt,,  that  interrupt  should  not  be  generated  by  an 
EXEC  statement. 


^AISMRrjT  FORMAT 


LABEL 

OPEBANns 

EXEC 

■i  nj£jrJiaiiie_.  _ 

in t -name 

The  "int-narae"  field  specifies  the  name  of 
Hie  interrupt  which  is  to  be  generated  by  this  statement. 
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* 


MEMORY 


The  MEMORY  statement  examines  the  memory 
map  of  the  object  system  to  determine  whether  there 
is  sufficient  memory  to  load  a  transaction  item  within 
the  range  of  memories  specified.  The  transaction  item 
for  which  the  memory  test  is  made  may  be  either  the 
available  transaction  (AT)  or  it  may  be  a  transaction 
resident  on  a  specified  queue.  The  possible  results 
from  the  memory  test  are  as  follows:  1.  There  is  not 
enough  memory  in  the  object  system.  2.  A  PACK  operation 
would  be  required  before  the  transaction  item  can  be 
loaded.  3.  There  is  sufficient  memory  in  the  object 
system  to  load  the  transaction  item. 


STATEMENT 

FORMAT 

LABEL 

OP -CD 

OPERANDS 

MEMORY 

mem-name  1,  mem-name  2  (,q-name) 

NS  I 

NSI+1 

NSI+2 

mem -name  1 


The  "mem-name  1"  field  specifies  the  name  of 
the  first  memory  in  the  range  to  be  tested  by  the 
memory  statement . 
mem-name  2 

The  "mem-name  2"  fieic.  specifies  the  name  of 
the  last  memory  in  the  memory  range  to  be  tested  by 
this  statement. 
q -name 

If  the  "queue-name"  field  is  omitted  from  the 
MEMORY  statement,  the  transaction  for  which  the  MEMORY 
test  will  be  made  must  be  the  available  transaction  (AT) 

If  the  ."queue -name"  field  is  supplied  for  the 
MEMORY  statement,  the  transaction  item  for  which  the 
MEMORY  test  will  be  made  must  be  on  the  specified  queue. 
The  specific  item  on  the  queue  for  which  the  memory  test 
will  be  made  may  be  adjusted  by  use  of  the  EXAMINE  state 


ments 


The  NSI  statement  will  be  executed  if  there 
is  not  enough  memory  in  the  range  specified  to  load 
the  transaction  item  specified. 

NSI+1 

The  NSI+1  statement  will  be  executed  if  a 
PACK  statement  must  be  performed  before  there  will 
be  sufficient  memory  in  the  range  specified  to  load 
the  transaction  item  specified. 

NSI +2 

The  NSI+2  statement  will  be  executed  if 
there  is  sufficient  memory  available  to  load  the 


transaction  item  specified. 
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ALLOCATE 


The  ALLOCATE  statement  is  used  in  conjunction 
with  the  MEMORY  statement.  Once  the  MEMORY  statement 
has  determined  that  there  is  sufficient  memory  avail¬ 
able  to  load  a  transaction  item  the  ALLOCATE  statement 
may  be  used  to  assign  the  storage  to  the  transaction 
item.  It  is  important  to  note  that  attempting  to  per¬ 
form  an  ALLOCATE  statement  when  sufficient  memory  is  not 
available  will  terminate  the  simulation.  In  addition 
the  memory  range  specified  for  the  ALLOCATE  statement 
must  be  exactly  the  same  as  for  the  corresponding 
MEMORY  statement. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

oPEK.vros 

ALLOC 

mem-name  1,  mem-name  2 

mem -name  1 

The  "meiu-narae  1"  field  specifies  the  name  of 
the  first  memory  in  the  range  of  memories  to  be  used  for 


this  allocation 


4 
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mem~name  2 

The  '’mem-name  2"  field  specifies  the  name 
of  the  last  memory  in  the  range  of  memories  to  be  used 
for  this  allocation. 


DEALLOCATE 


The  deallocate  statement  exeanines  the 
object  memory  map  and  releases  all  memory  assigned 
to  the  current  available  transaction  (  AT  ) .  However, 
j-f  the  worker  routine  being  used  by  the  current  avail¬ 
able  transaction  has  been  specified  as  being  reentrant 
and  ther.'j  is  another  active  transaction  item  associated 
with  this  worker  routine  only  the  data  and  I/O  storage 
are  released,  instruction  storage  remains  allocated. 

Fc'  a  reentrant  worker  routine  of  this  type,  instruction 
storage  is  released  when  a  DFJALLOCATE  statement  is 
executed  for  the  last  active  transaction  item  utilizing 
that  worker  routine. 

The  DEALLOCATE  statement  is  normally  followed 


by  a  DESTROY  statement  to  eliminate  the  terminated 
transaction  item  from  the  system. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS 

DALLOC 
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There  are  no  operands  associated  with  the 
DEALLOCATE  statement. 

ERROR  CONDITIONS 

Any  attempt  to  execute  a  RETURN  to  an  avail¬ 
able  transaction  which  has  no  memory  allocated  to  it 
will  generate  a  diagnostic  and  terminate  the  simulation. 


% 
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PACK 


The  PACK  statement  provides  the  ability  to 
reorganize  the  contents  of  a  range  of  memories.  The 
PACK  statement  moves  all  pages  which  are  currently 
assigned  to  the  low  end  of  the  memory  range  thereby 
leaving  all  free  pages  at  the  high  end  of  the  memory 
range.  This  allows  an  operating  system  to  represent 
the  dynamic  reorganization  of  memory  when  a  transaction 
item  requires  more  contiguous  storage  than  is  currently 
available . 

For  an  operating  system  which  provides 
dynamic  compacting  of  memory  when  necessary,  the 
PACK  statement  is  normally  coded  at  the  NSI+1  exit 
line  from  the  MEMORY  statement.  This  statement  would 
then  be  followed  by  an  ALLOCATE  statement  as  the  NSI+2 
exit  line.  For  an  operating  system  which  atomatically 
reorganizes  memory  whenever  a  transactioi.  i  era  has  its 
memory  deallocated,  the  PACK  statement  is  normally 
coded  immediately  following  the  DEALLOCATE  statement. 
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STATEMENT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

PACK 

mem-name  1 ,  mem-name  2 

mem-name  1 

The  "mem-name  1"  field  specifies  the  first 


memory  in  the  range  of  memories  for  which  the  PACK  is 
to  be  performed. 
mem-name  2 

The  "mem-name  2"  field  specifies  the  name  of 
the  last  memory  in  the  range  for  which  the  PACK  is  to 
be  performed. 


% 
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EXAMINE  FIRST 


The  EXANilNE  FIRST  statement  sets  the  queue 
pointer  to  the  first  entry  in  the  specified  queue.  A 
test  is  then  performed  to  determine  if  there  is  an  item 


in  the  first  entry.  The  EXAMINE  FIRST  statement  does 
not  alter  the  contents  of  the  queue  in  any  way. 


STATEMENT  FORNiAT 

LABEL 

OP-CD 

OPERANDS 

EXAM-F 

q-name 

NSI 

NSI+1 

•  • 

q-name 

The  "q-name"  field  specifies  the  name  of  the 
queue  for  which  the  EXAMINE  FIRST  operation  is  to  be 
perf  ormed . 

NSI 

The  NSi  statement  will  be  executed  if  there 


is  no  item  in  the  first  entry  of  the  specified  queue. 


NSI+1 


The  NSI-f-i  statement  will  be  executed  if 
there  is  an  item  in  the  first  entry  of  the  queue 
specified. 
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EXAMINE  NEXT 


The  EXAMINE  NEXT  statement  alters  the  queue 
pointer  for  the  specified  queue  by  one  position.  The 
EXAMINE  NEXT  statement  mast  be  preceded  by  an  EXAMINE 
FIRST  or  an  EXAMINE  LAST  statement  for  the  saune  queue. 
If  this  statement  was  preceded  by  an  EXAMINE  FIRST 
statement,  then  the  queue  pointer  is  altered  to  look 
at  the  next  item  down  the  queue.  If  this  statement 
was  preceded  by  an  EXAMINE  LAST  statement  then  the 
queue  pointer  is  altered  to  look  at  the  next  item  up 
the  queue.  Once  the  queue  pointer  has  been  JJltered 
a  test  is  made  to  determine  if  the  new  entry  for 
which  the  queue  pointer  is  set  contains  an  item  or 
not.  The  EXAMINE  NEXT  statement  does  not  alter  the 
contents  of  the  queue  in  any  way. 


1  STATEMENT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

EXAM-N 

C-narae 

MCT 

L -  -  ■  -  .  -  -  - -  - - 
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q-name 

The  ”q-name"  field  specifies  the  name  of  the 
queue  for  which  the  EXAMINE  NEXT  statement  is  to  be 
executed . 

NSI 

The  NSI  statement  will  be  executed  if  the 
current  queue  entry  does  not  contain  an  item. 

NSI+1 

The  NSI+i  statement  will  be  executed  if  the 
current  entry  for  the  queue  specified  does  contain  an 
item. 


% 
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C 

EXAMINE  LAST 

The  EXAMINE  LAST  statement  sets  the  queue 
pointer  to  the  last  entry,  if  any,  in  the  queue  spec¬ 
ified.  A  test  is  then  performed  to  determine  if  there 
is  an  item  in  the  queue.  The  EXAMINE  LAST  statement 
does  not  alter  the  contents  of  the  queue  in  any  way. 


/ 


q-name 

The  "q-name"  field  specifies  the  name  of  the 
queue  for  which  the  EX/\MINE  LAST  statement  will  be  executed. 
NSI 

The  NSI  statement  will  be  executed  if  there 
are  no  items  on  the  queue  for  which  the  EXAMINE  LAST 
statement  was  executed. 


[statement  format 

LABEL 

OP-CD 

OPERANDS 

EXAM-L 

q-narae 

NSI 

NSI+1 

NSI+l 

The  NSI-t-1  statement  will  be  executed  if 
there  is  an  item  available  in  the  queue  for  which  the 
EXAMINE  LAST  statement  was  executed. 
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PLACE 


The  PLACE  statement  provides  the  ability  to 
put  the  available  transaction  word  or  the  I/O  transaction 
word  specified  onto  any  selected  queue.  The  manner  in 
which  the  place  is  performed  is  determined  by  the  queueing 
method  selected  when  defining  the  queue.  If  queueing  is 
by  priority,  the  current  item  will  be  placed  after  any 
other  items  in  the  queue  which  have  the  same  priority 
level.  If  the  queueing  method  selected  is  f irst-in-f ir«^+- 
out  the  current  item  will  be  placed  ahead  of  any  other 
item  on  the  queue.  Once  the  PLACE  operation  has  been 
performed  the  queue  pointer  is  set  equal  to  the  beginning 
of  the  queue,  as  if  an  EXAMINE  FIRST  had  been  executed. 


STATEMENT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

PLACE 

(AT,IOT) ,q-narae 
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The  AT  operand  specifies  that  the  transaction 
word  to  be  placed  will  be  found  in  the  AT  word  for  the 
current  operating  CPU. 
lOT 

The  lOT  operand  specifies  that  the  trainsaction 
item  to  be  placed  will  be  found  in  the  lOT  word  for  the 
current  operating  CPU. 
q -name 

The  "q-name"  field  specifies  the  niime  of  the 
queue  for  which  the  place  operation  is  to  be  performed. 
ERROR  CONDITIONS 

Any  attempt  to  place  a  zero  transaction  word 
on  a  queue  or  to  place  a  transaction  word  on  a  queue 
which  is  full  will  cause  the  generation  of  an  error 
message  and  the  termination  of  the  simulation. 


SELECT 


The  SELECT  statement  provides  the  capability 
to  remove  a  transaction  word  from  a  queue  and  place  it 
into  either  the  AT  or  the  lOT  word  for  the  current 
operating  CPU.  The  item  to  be  selected  from  the 
specified  queue  is  determined  by  the  queue  pointer  for 
that  queue.  As  has  been  previously  described,  the 
queue  pointer  may  be  manipulated  by  the  EXAMINE 
statements.  When  the  SELECT  statement  is  executed, 
the  AT  or  lOT  slots  specified  must  be  zero  as  a 
result  of  either  placing  the  item  previously-con¬ 
tained  on  some  queue  or  executing  a  DESTROY  state¬ 
ment  . 

A  SELECT  statement  must  be  preceded  by  an 
PXA  ’lf'fE  statement  so  that  no  attempt  will  be  made  to 
select  a  zero  item  from  a  queue.  In  addition,  since 
the  queue  definition  specifies  whether  a  queue  may 
contain  transaction  items  or  10  transaction  items, 
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no  axtempt  must  be  made  to  select  an  available  trans¬ 
action  from  an  I/O  transaction  queue  or  an  10  trans¬ 
action  from  an  available  transaction  queue. 


STATEMEN 

r  FORMAT 

LABEL 

OP -CD 

OPERANDS 

, .SSLECT 

( AT , lOT ) ,  q-name 

The  AT  operand  specifies  that  the  item 


selected  from  the  queue  is  to  be  placed  into  the 
available  transaction  slot  in  the  current  operating 
CPU. 
lOT 

The  lOT.  operand  specifies  that  the  item 
selected  from  the  queue  is  to  be  placed  into  the  10 
transaction  item  slot  in  the  current  operating  CPU. 
q -name 

The  "q-name"  field  specifies  the  name  of 
the  queue  for  which  the  select  statement  is  to  be 


executed . 
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ERROR  CONDITIONS 

Attempting  to  SELECT  a  transaction  word 
into  an  AT  or  lOT  word  which  is  not  zero  will  cause 
an  error  message  to  be  generated  and  the  simulation 
to  terminate. 

Attempting  to  SELECT  a  zero  transaction  word 
from  a  queue  will  cause  an  error  message  to  be  generated 
and  the  simulation  to  terminate. 
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BUFFER 


The  BUFFER  statement  provides  the  ability 
for  the  operating  system  to  test  the  current  status 
of  the  record  and  buffer  counts  for  an  ordinal  file. 
When  a  worker  routine  READ  or  WRITE  statement  is 
executed  control  is  transferred  to  the  operating 
system  by  means  of  a  READ/WRITE  interrupt.  At  this 
point,  it  is  necessary  to  code  a  BUFFER  statement. 

The  BUFFER  statement  determines  whether  a  record  is 
available  and/or  an  I/O  operation  is  necessary. 

There  are  no  operands  required  for  the  BUFFER 

statement . 


STATEMENT  FORMrlT 

LABEL 

OP-CD 

OPERANDS 

BUFF 

iNST 

NSI+l 

NSI+2 
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NSI 

The  NSI  statement  is  executed  if  there  is  a 
record  available  and  there  is  no  empxy  buffer  for  the 
file  specified  by  the  last  R;iAD  or  WRITE  statement. 
The  NSI  is  normally  coded  as  a  RETURN  to  the  worker 
routine  which  issued  the  READ  or  WRITE  statement. 
NSI-t-l 

The  NSI+1  statement  is  executed  if  a  record 
is  available  but  a  buffer  has  become  empty  or  full. 
The  fact  that  a  buffer  has  been  depleted  indicates 
an  I/O  operation  should  be  initiated  at  that  point. 
Therefore,  an  I/O  transaction  item  is  created  for 
this  exit  line  by  the  BUFFER  statement.  Normally, 
the  NSI+1  exit  line  should  transfer  contiol  to  an 
lOREADY  test.  At  this  point,  the  I/O  operation  can 
either  be  initiated  if  all  required  I/O  facilities 
are  available,  or  else  the  I/O  transaction  item  may 
be  placed  on  a  queue  until  the  required  facilities 
are  available.  It  should  be  noted  however,  that  the 
current  available  transaction  need  not  be  deferred 
since  at  least  one  buffer  is  currently  available. 


NSI+-2 


The  NSI+2  statement  is  executed  of  there 
are  no  records  available  for  tht*  available  trans¬ 
action.  This  exit  line  can  be  reached  only  if  all 
possible  I/O  operations  have  been  previously  initiated 
but  not  yet  complete.  Since  all  possible  I/O  operations 
have  been  initiated,  no  new  I/O  transaction  item  is 
created  for  this  exit  line.  The  normal  coding  at  this 
point  would  be  to  place  the  worker  routine  on  a  deferred 
queue  and  to  select  a  new  available  transaction. 

NSH-3 

The  NSI+3  statement  is  executed  only  if 
the  available  transaction  is  an  operating  system 
transact' on.  Since  all  I/O  requests  by  the  operating 
system  are  considered  to  be  unoiocked  and  unbuffered 
each  time  this  exit  line  is  taken  an  I/O  transaction 
item  is  created.  The  normal  coding  at  this  point 


would  oe  a  transfer  to  the  lOREADY  test. 


The  SEEK  statenent  provides  the  ability  to 
test  ar»  I/O  transaction  iteia  to  deteraine  if  a  SEEK 
ojjcration  way  be  pcrforaed.  In  order  for  the  SE.^ 
operation  to  bo  perfomeb  the  I/O  transaction  item 
must  reference  a  randon  excess  device  using  a  to-froa 
table.  If  the  SEEK  statesenr  is  used  under  those 
conditions  the  seek  tiicc  specified  in  the  to-frora  table 
will  be  applied  to  the  device  c~'ly,  and  the  channel  and 
control  unit  will  be  considered  free  for  this  tiae. 

If  a  SEEK  statement  is  not  used,  the  seek  tiE?e  specified 
in  the  to-from  *  le  will  be  idded  to  the  READ/WRITE 
time  and  will  hold  the  charr.el,  control  unit,  and  device 
busy  for  the  entire  operation. 
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NSI 

The  NSI  statement  is  executed  if  a  SEEK  has 
been  initiated  as  a  result  of  this  statement.  If 
this  exit  line  is  taken  the  lOT  is  now  set  to  zero. 

When  the  seek  operation  is  completed  an  END  OF  SEEK 
interrupt  will  be  generated  and  the  I/O  trao^saction 
item  will  be  returned  to  the  user. 

NSI-t-l 

The  NSI+1  statement  will  be  executed  if 
no  seek  iaa3'  be  performed  for  the  current  I/O  trans¬ 
action.  If  this  statement  is  executed,  the  I/O  trans¬ 
action  item  is  still  available  and  an  lOADVANCE  operation 
will  be  required. 

NOTE 

The  SEEK  statement  must  not  be  executed 
until  aftei  an  iOREADY  has  been  successfully  performed. 
ERROR  CONDITIONS 

Any  attempt  to  execute  a  R'~TURN  to  an  avail¬ 
able  transaction  whic)  has  no  memory  allocated  to  it 
will  generate  a  diagnostic  and  terminate  the  simulation. 


lOREADY 


The  lOREADY  ste.  ’loent  is  used  to  determine 
whether  the  facilities  (file,  device,  and  charnel 
control  unit  pair;  required  for  an  lO  operation  are 
available.  The  lOREADY  Test  may  be  made  on  the 
current  lOT  or  on  the  current  item  in  a  specified 
queue . 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS 

lOREADY 

(q-name ) 

NSI 

NSI+1 

q-name 

If  the  "q-naae"  field  is  omitted  from  this 


statement,  the  lOREADY  Test  is  made  on  the  current 
lOT,  If  the  queue  operand  is  included  the  lOREADY 
Test  will  be  performed  on  the  current  item  in  the 
specified  queue.  The  current  item  in  a  queue  may  be 
adjusted  by  means  of  the  EXAMINE  statement. 


The  NSI  statement  is  executed  if  the  facilities 


required  for  this  I/O  operation  are  not  currently  avail¬ 
able  . 

NSI+l 

The  XSI+1  statement  is  executed  if  the  facilities 
required  for  this  I/O  operation  are  available. 

Error  Conditions 

If  the  q-name  operand  is  included  in  this  state¬ 
ment  the  queue  specified  must  contain  I/O  transaction 
items.  Attempting  to  perform  the  lORBADY  operation  on 
a  queue  which  does  net  contain  I/O  transaction  items 
will  generate  ^^n  error  message  and  terminate  the 
simulation. 

If  the  q-name  operand  is  omitted  from  this 
statement  and  the  I/O  transaction  word  is  zero  the 
simulator  will  generate  an  error  message  and  terminate 


the  simulation 
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lOADVANCE 


The  lOADVANCE  statement  is  used  to  initiate 
the  10  operation  for  the  current  lOT.  A  successful 
lOREADY  statement  must  have  been  executed  for  the 
current  lO  transaction  item  before  the  lOADVANCE 
statement  may  be  executed.  The  interpretation  of 
an  lOADVANCE  statement  will  place  the  current  I/O 
transaction  item  on  the  future  events  chain  for  the 
time  required  to  perform  the  requested  10  operation. 
In  addition,  the  current  lOT  is  set  equal  to  zero. 


STATEMENT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

lOADV 

There  are  no  operands  associated  with  the 
lOADVANCE  statement. 

Error  Conditions 

If  an  lOREADY  statement  has  not  been  e:  'uted 


for  the  current  I/O  transaction  item  when  an  lOADVANCE 


statement  is  executed,  a  diagnostic  will  be  issued 
and  the  simulation  terminated. 

Attempting  to  perform  an  lOADVANCE  statement 
with  a  zero  I/O  transaction  word  will  generate  an  error 
message  and  terminate  the  simulation. 

Once  a  successful  lOREADY  statement  has  been 
executed  for  an  I/O  transaction  item,  no  other  lOREADY 
operation  may  be  performed  before  the  lOADVANCE  state¬ 
ment  is  executed  for  the  same  lOT.  In  general,  this 
means  that  any  compute  placed  between  a  successful 
lOREADY  and  the  corresponding  lOADVANCE  must  have 
all  interrupts  disabled. 
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lOTERM 


The  lOTERM  statement  is  used  to  select  trans¬ 
action  items  off  of  the  deferred  queue  once  the  required 
I/O  operation  has  been  performed.  A  transaction  item  is 
normally  placed  on  the  I/O  deferred  queue  because  it  has 
requested  a  record  which  is  not  currently  available.  In 
order  for  there  to  be  no  records  available  for  a  given 
file  the  buffer  for  that  file  must  have  been  previously 
emptied.  Every  time  a  buffer  is  emptied  the  BUFF  state¬ 
ment  creates  an  I/O  transaction  item  which  will  be  used 
to  fill  the  buffer  again.  Therefore,  once  the  I/O 
operation  requested  by  the  I/O  transaction  item  has  been 
completed  the  transaction  item  which  was  placed  on  the 
I/O  deferred  queue  may  once  again  proceed. 

The  lOTERM  statement  tests  the  item  indicated 
by  the  current  setting  of  the  queue  pointer,  for  the 
queue  specified,  to  determine  if  the  item  is  a  trans¬ 
action  item  which  can  now  proceed  due  to  the  termination 
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of  the  current  I/O  transaction  item.  A  transaction 
item  is  considered  to  be  able  to  proceed  if  it  generated 
the  current  I/O  transaction  item,  and  if  the  current 
I/O  transaction  item  has  filled  the  empty  buffer  which 
caused  this  I/O  transaction  item  to  be  placed  on  the 
I/O  deferred  queue .  A  transaction  item  may  not  be 
selected  off  the  I/O  deferred  queue  if  any  opened  file 
has  one  or  more  empty  buffers. 


1  STATEMENT  FORMAT  | 

LABEL 

OP -CD 

OPERANDS 

lOTERM 

q -name 

NSI 

.. 

NSI-^1 

q-name 

The  "q-name"  field  specifies  the  name  of  the 
queue  which  is  to  be  examined  by  the  lOTERM  statement. 


NSI 

The  NSI  statement  will  be  executed  if  the 
current  item  in  the  specified  queue  may  not  be  selected. 


Ill 


NSI-H 

The  NSI+1  statement  will  be  executed  if  the 
current  item  in  the  queue  specified  may  be  selected 
and  removed  from  the  I/O  deferred  queue. 

Error  Conditions 

If  the  queue  specified  by  the  q-name  operand 
does  not  contain  transaction  items  a  diagnostic  message 
will  be  supplied  and  the  simulation  terminated. 


Operating  System  Switches 


There  are  three  statements  provided  in  the 
simulator  whioh  handle  the  setting  and  testing  of 
switches  provided  for  use  by  operating  systems  and 
primary  worker  routines.  The  three  statements  are 
SET,  UESET,  and  TEST.  The  SET  statement  may  be  used 
to  turn  one  of  the  available  switches  on,  the  RESET 
statement  may  be  used  to  turn  one  of  the  switches 
off,  and  the  TEST  statement  may  be  used  to  exaimine  one 
of  the  available  switches  and  determine  whether  it 
is  currently  on  or  off. 

Local  Switches 

The  simulator  provides  twenty  switches 
which  are  considered  local  to  a  single  CPU.  These 
local  switches  are  numbered  con.secutively  from  one 
to  twenty.  Local  switches  are  particularly  useful 
when  a  single  operating  system  is  shared  between  two 
or  more  CPU's.  For  example,  if  CPU  number  one  is 


currently  executing  in  the  operating  syitem  and 
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executes  a  set  1  instruction  switch  number  one  for 
CPU  number  one  will  be  turned  on.  However,  switch 
number  one  for  CPU  number  one  is  distinct  from  switch 
number  one  for  CPU  number  two.  Therefore,  if  CPU 
number  two  were  now  to  execute  a  test  1  instruction 
that  switch  might  well  be  off. 

Global  Switches 

The  simulator  provides  one  hundred  global 
switches  numbered  consecutively  from  101  to  200. 

The  global  switches  provided  may  be  manipulated  by 
the  three  statements  above  in  the  same  way  as  locrl 
switches.  However,  these  switches  may  be  referenced 
by  any  one  of  the  CPU's  in  a  single  simulation. 
Specifically,  if  CPU  number  one  references  switch 
101  and  CPU  number  two  references  switch  number 
101  they  are  both  referencing  the  same  switch. 


r 
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SET 


The  SET  statement  is  used  to  turn  on  one 


of  the  local  or  global  switches  provided  by  the 
simulator.  If  the  switch  to  be  SET  is  already  on, 
it  will  be  left  on. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERAND 

SET 

switch 

switch 

The  ’’switch”  field,  specifies  the  number  of 


the  switch  to  be  turned  on.  If  the  number  of  the 
switch  is  in  the  range  from  1  to  20  the  switch  turned 
on  will  be  a  local  switch.  If  the  number  of  the  switch 
to  be  turned  on  is  in  the  range  from  101  to  200  the 
switch  turned  on  will  be  a  global  switch. 
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RESET 


C 


The  RESET  statement  is  used  to  turn  off  one 


of  the  local  or  global  switches  provided  by  the  simu¬ 
lator.  If  the  switch  to  be  RESEI  is  already  off  it 
will  be  left  off. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OrERANDS 

RESET 

swi tch 

switch 

The  "switch"  field  specifies  the  number  of 


the  switch  to  be  turned  off.  If  the  number  of  the 
switch  is  in  the  range  from  1  to  20  the  switch  to  be 
turned  off  is  a  local  switch.  If  the  number  of  the 
switch  to  be  turned  off  is  in  the  range  from  101  to 
200  the  switch  to  be  turned  off  is  a  global  switch. 


o 


TEST 


The  TEST  statement  allows  the  user  to  deter¬ 


mine  if  one  of  the  local  or  global  switches  provided 
by  the  simulator  is  currently  on  or  off. 


STATEMENT 

FORMAT 

LABEL 

OP-CD 

OPERANDS 

TEST 

switch 

NSI 

NSI+1 

switch 

The  "switch"  field  specifies  the  number  of 


the  switch  to  be  tested.  If  the  number  of  the  switch 
is  in  the  range'from  1  to  20  the  switch  to  be  tested 
is  a  local  switch.  If  the  number  of  the  switch  is  in 
the  range  from  101  to  200  the  switch  to  be  tested  is 
a  global  switch. 

NSI 

The  NSI  statement  will  be  executed  if  the 
switch  tested  is  currently  on. 
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NSH-1 

The  NSI+1  statement  will  be  executed  if  the 
switch  to  be  tested  is  currently  off. 

NOTE 

At  the  beginning  of  any  simulation  all  of  the 
available  switches  are  initialized  to  the  off  position. 


i 
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INTERRUPT 

The  INTERRUPT  statement  allows  an  operating 
system  to  generate  an  interrupt  which  will  be  placed 
at  the  top  of  the  future  events  chain.  However,  the 
current  operating  program  will  not  lose  control  of 
the  CPU  until  some  statement  which  advancG:^  simulated 
time  is  executed .  If  the  user  wishes  the  interrupt 


to  take  place  immediately  the  interrupt  statement  may 
be  followed  by  a  COMPUT  J.  statement. 


STATEME 

NT  FORMAT  | 

LABEL 

OP -CD 

OPERANDS 

INTER 

cpu-name,  int-name 

cpu-name 

The  "cpu-name"  field  specifies  the  neime  of 
the  CPU  which  is  to  receive  this  interrupt. 
int-najne 

The  int-name  operand  specifies  the  name  of  the 
interrupt  which  will  be  generated  for  the  specified  CPU. 
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It  should  be  noted  that  specifying  the  name  of  an 
in'^exiupt  which  has  previously  been  defined  by  the 
system  may  be  a  cause  of  problems.  For  example,  if 
the  interrupt  name  specified  is  normally  the  CLOSE 
interrupt  the  operating  system  may  expect  to  find  an 
I/O  transaction  item  where  in  fact  the  interrupt 
generated  by  this  sxatement  will  not  provide  an  I/O 
transaction  item. 

ERROR  CONDITIONS 

The  specification  of  cm  interrupt  name  which 
has  not  been  defined  for  the  CPU  specified  will  cause 
the  generation  of  an  error  message  and  the  termination 
of  the  simulation. 
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DISABLE 

The  DISABL  statement  allows  the  user  to 
defer  the  occurrence  of  any  or  all  interrupts .  If 
an  interrupt  generating  transaction,  upon  reaching 
the  top  of  the  future  events  chain,  finds  that  its 
interrupt  has  been  disabled,  it  will  remain  on  the 
future  events  chain  until  an  ENABLE  statement  specify¬ 
ing  its  interrupt  allows  it  to  enter  the  interrupt 
routine. 

STATEMENT  FORMAT 
LABEL  OP-CD  OPERANDS 

DISABL  (All,  int-name) 


The  ALL  operand  specifies  that  all  interrupts 
defined  for  the  current  CPU  are  to  be  disabled. 
int-name 

The  ”int-naune’*  field  specifies  the  name  of 
a  single  interrupt  which  is  to  be  disabled  .‘or  the 


current  CPU 
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ERROR  CONDITIONS 


Specifying  the  name  of  an  interrupt  which 


has  not  been  defined  for  the  current  CPU  by  means  of 
the  int-name  operand  v/ill  cause  the  generation  of  an 


error  message  and  the  termination  of  the  simulation. 


C 


c 


ENABLE 


The  ENABLE  statement  allows  the  user  to 
reverse  the  action  specified  in  a  DISABL  statement. 

If  there  is  a  transaction  item  at  the  top  of  the 
future  events  chain  which  could  not  generate  an  inter¬ 
rupt  because  its  interrupt  was  disabled,  the  interrupt 
will  occur  as  soon  as  a  CPU  advance  time  occurs. 


STATEMENT  FORMAT 

T.ARRT. 

OP-CD 

OPERANDS 

ENABLE 

(ALL,  in t -name) 

ALL 

The  ALL  operand  specifies  that  all  disabled 
interrupts  are  now  to  be  enabled. 
int-najne 

The  "int-name"  field  specifies  the  name  of 
the  single  interrupt  which  is  to  be  enabled  by  this 


statement 


BRROK  CONDITIONS 


If  the  name  of  an  interrupt  which  has  not 
been  defined  for  the  current  CPU  is  specified  by  means 
of  the  int-name  operand  a  diagnostic  mess^ige  will  be 


issued  and  the  simulation  terminated 


CLOCK 


There  is  ore  simulated  interval  iimer  for 
each  CPU  in  a  given  simulation.  When  the  interval 
timer  for  any  given  CPU  reaches  zero  a  clock  in  errupt 
for  that  CPU  will  occur  unless  the  CLOCK  interrupt  is 
disabled.  Therefore,  the  CLOCK  statement  is  always 
interpreted  relative  to  the  current  operating  CPU. 

The  CLOCK  statement  is  used  to  set  the  sim* 
uloted  interval  timer  for  the  current  operating  CPU. 
When  the  CLOCK  statement  is  interpreted,  tte  value  of 
the  TIME  operand  is  placed  into  the  simulated  interval 
timer  destroying  any  previous  setting.  Once  the 
interval  timer  has  reached  zero,  thereby  generating 
an  interrupt,  no  new  interrupt  will  occur  un+xl  the 
interval  timer  has  Deen  reset  by  a  new  CIKX3C  state¬ 
ment  . 


STATEMENl 

r  FC»MAT 

LABEL 

OP -CD 

OPERANDS 

CLOCK 

time 
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tine 


The  ’’time”  field  specifies  the  time  in 
microseconds  which  is  to  be  placed  into  the  interval 
timer  for  the  current  operating  CPU.  The  value  of 
this  field  must  be  in  the  form  DDUE.  The  format  DDDE 
is  interpreted  as  a  number  in  the  range  from  1  to  999 
with  an  exponent  in  the  range  from  0  to  9. 
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RETURN 


The  RETURN  statement  is  used  to  leave  the 
operating  system  and  return  to  the  next  sequential 
instruction  for  the  availaole  tr;\nsaction.  The 
available  transaction  will  normally  represent  a 
worker  routine,  but  it  may  also  represent  a  primary 
worker  or  another  op'^r*  ng  system  transaction. 

When  a  RETURN  statement  is  interpreted,  the  current 
operating  transaction  (COT),  representing  the  operating 
system,  is  destroyed  ajid  the  available  trsmsaction  (AT) 
representing  the  worker  routine,  becomes  the ’’current 
operating  transaction. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS 

RETURN 

l.here  are  no  operands  associated  v/ith  the 


RETURN  statement 
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Error  Conditions 

A  RETURN  statement  may  not  be  executed  if 
there  is  no  available  transaction  or  if  there  is  an 
I/O  transaction  in  the  current  CPU  item.  If  either  of 
these  error  condi tions  are  found  to  exist  an  appropriate 
diagnostic  message  is  generated  and  the  simulation  is 


terminated 


ACTIVATE 


The  ACTIVATE  statement  causes  the  immediate 
generation  of  a  transaction  for  the  worker  routine 
specified  by  the  job-name  operand.  In  addition,  the 
transaction  word  for  the  rewly  generated  transaction 
is  placed  into  the  available  tremsaction  (AT)  position 
in  the  current  CPU  item.  Before  the  operating  system 
executes  cin  ACTIVATE  statement,  the  available  trans¬ 
action  in  the  current  CPU  item  must  be  set  to  zero  by 
using  a  DESTROY  statement  or  a  PLACE  statement. 


STATEMEN1 

[“  FORMAT 

*• 

LABEL 

OP-CD 

OPERANDS 

ACTIV 

job -name 

job-name 

The  "job-name”  field  raust  contain  the  name  of 


the  worker  routine  for  which  a  transaction  is  to  be 
generated  by  the  ACTIVATE  statement. 
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Error  Conditions 

Attempting  to  execute  an  ACTIVATE  statement 
when  the  available  transaction  word  is  not  zero  in 
the  current  CPU  item  will  cause  the  generation  of  a 
diagnostic  message  and  the  termination  of  the  simu¬ 
lation. 

Attempting  to  activate  a  transaction  for  a 
worker  routine  which  has  not  been  defined  for  the 
current  simulation  will  cause  the  generation  of  an 
error  diagnostic  and  the  termination  of  the  simulation. 
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RECEIVE 


The  RECEIVE  statement  takes  the  transaction 
word  associated  with  a  transaction  which  has  just  gener¬ 
ated  a  RECEIVE  interrupt  and  makes  it  the  available  trans¬ 
action  for  the  current  operating  CPU.  Before  executing 
the  RECEIVE  statement,  the  opera!  ..g  system  must  insure 
that  the  available  transaction  word  for  the  current  CPU 
is  zero.  This  may  be  performed  by  either  the  PLACE  state¬ 
ment  or  the  DESTROY  statement. 

In  a  multiprocessor  system  v;here  two  or  more 
CPU's  share  the  same  operating  system,  the  operating  system 
must  insure  that  the  CPU  which  accepted  the  RECEIVE  interrupt 
is  the  same  CPU  which  executes  the  RECEIVE  statement.  There¬ 
fore,  any  statements  olaced  between  the  beginning  of  the 
RECEIVE  interrupt  vector  and  the  RECEIVE  statement  which 
advances  time,  must  have  all  interrupts  disabled. 


STATEMENT  FORMAT 

LABEL 

OP-C.l 

OPERANDS 

RECEIV 

There  are  no  operands  associated  with  the  RECEIVE 


statement 
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Error  Conditions 


If  the  .aCEIVE  statement  is  executed  by  any 
CPU  which  does  not  have  a  receiver  interrupt  pending 
a  diagnostic  message  will  be  issued  and  simulation 


terminated 


r 
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CYCLE 

The  CYCLE  statement  allows  an  operating 
system  to  enter  the  WAIT  state  when  the  CPU  has  nc 
further  processing  to  do.  Normally,  the  CYCLE  state¬ 
ment  will  be  issued  only  when  there  is  no  available 
transaction  in  the  entire  system.  Before  executing 
a  CYCLE  statement  the  operating  system  must  insure 
that  all  interrupts  are  enabled,  the  available  trans¬ 
action  word  is  zero,  and  the  I/O  transaction  word  is 
zero. 


There  are  no  operands  associated  with  the 
CYCLE  statement . 

Error  Conditions 

,  If  the  CYCLE  statement  is  executer.  when  the 

available  transaction  or  the  1/ ~  trauisaction  for  the 
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current  CPU  item  is  not  zero,  a  diagnostic  message  will 

b«  issued  and  the  simulation  terminated. 

If  a  CYCLE  statement  is  executed  when  there 
is  no  possible  interrupt  on  the  future  events  chain 
an  error  diagnostic  will  be  issued  and  the  simulation 


terminated 


DESTROY 


The  DESTROY  statement  causes  the  specified 


transaction  word  for  the  current  CPU  item  to  be 
cleared  to  zero  and  the  associated  transaction  item 
to  be  removed  from  the  system. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

DPER/iNDS 

DESTROY 

(AT,IOT) 

The  AT  operand  specifies  that  the  available 


transaction  word  for  the  current  CPU  item  is  to  be  set 
to  zero  and  the  available  transaction  item  is  to  be 
cleared  from  the  system.  The  AT  operand  is  normally 
used  only  as  the  result  of  a  worker  program  term¬ 
ination. 
lOT 

The  lOT  operand  specifies  that  the  10  trans¬ 
action  word  for  the  current  CPU  item  is  to  be  set  to 
zero  and  the  associated  10  transaction  item  is  to  be 


cleared  from  the  system.  The  lOT  operar.  is  normally 
used  only  as  a  result  of  the  termination  of  an  I/O 
operation. 

Error  Conditions 

If  the  CPU  item  specified  by  the  DESTROY 
statement  is  currently  zero  a  diagnostic  message  will 
be  issued  and  the  .simulation  terminated. 

Any  attempt  to  destroy  an  available  trans¬ 
action  item  (AT)  which  has  not  closed  all  opened  files 
will  cause  a  diagnostic  message  to  be  generated  and 
the  simulation  to  terminate. 


136 


PERIPHERAL 

The  PERIPHERAL  statement  allows  the  files 
and  devices  required  by  a  transaction  item  to  be 
examined  and,  if  available,  assigned  to  that  trans¬ 
action  item.  The  PERIPHERAl.  statement  user  the  inform¬ 
ation  provided  by  the  user  in  the  OF  statement  supplied 
for  every  worker  routine.  Only  those  files  and  devices 
which  the  user  specified  must  be  seized  by  a  transaction 
will  be  assigned  by  the  PERIPHERAL  statement. 


STATEMENT  FORMAT 

LABEL 

OP -CD 

OPERANDS 

_ 

PERI PH 

L _ ..J 

q-name 

q-namc 

If  the  "q-name"  field  is  omitted  from  this 


statement  the  PERIPHERAL  operation  will  he  performed 
with  respect  to  the  available  transaction  for  the 
current  CPU  item. 

If  the  QUEUE  operand  is  suppli>-d  for  this 
statement  the  PERIPHERAL  operation  will  be  executed 
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with  respect  to  the  current  transaction  item  in  the 
specified  q’.eue.  The  current  transaction  for  a 
queue  mey  J'c  Selected  by  means  of  the  EXAMINE  state¬ 
ment. 

Error  Conditions 

If  the  "q -name”  field  is  specified,  the  queue 
must  not  contain  I/O  transaction  words.  If  a  queue 
containing  I/O  transaction  words  is  supplied  a  diagnostic 
message  will  be  issued  and  the  simulation  terminated. 


DCYCLE 


The  DCYCLE  statement  allows  an  operating 
system  to  place  the  current  CPU  into  the  WAIT  state 
until  a  specified  interrupt  occurs.  Since  all  interrupts 
except  the  one  specified  will  be  disabled  the  operating 
system  must  insure  that  there  will  be  at  least  one 
interrupt  generated  from  the  specified  interrupt  source. 


STATEMENT  FORMAT 

LABET. 

OP-CD 

OPERANDS 

DCYCLE 

int-name 

int-name 

The  "int-name"  field  specifies  the  name  of  the 
interrupt  which  is  to  be  left  enabled  when  the  DCYCLE 
statement  is  interpreted.  All  interrupts  other  than  the 
one  specified  in  the  "int-name"  field  will  be  disabled. 
ERROR  CONDITIONS 

If  there  are  not  interrupts  on  the  future 
events  chian  for  the  single  interrupt  left  enabled  a 
diagnostic  message  will  be  issued  and  the  simulation 


terminated. 
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MATCH 


The  MATCH  statement  is  used  to  test  whether 
the  current  transaction  item  on  the  specified  queue 
has  been  delayed  until  the  termination  of  the  available 
transaction.  In  this  respect,  it  operates  much  like 
the  lOTERM  statement  does  for  I/O  transactions.  The 
MATCH  statement  would  normally  be  coded  in  the  program 
termination  interrupt  vector.  A  transaction  item 
would  normally  be  placed  on  the  MATCH  queue  due  to 
a  CALL  statement  with  a  DELAY  operand. 


STATEMENT 

FORMAT 

•  • 

rj^BEL 

OP-CD 

OPERANDS 

MATCH 

q-name 

NSI 

NSI+1 

q-name 

The  "q-name"  field  specifies  the  name  of  the 
queue  for  which  the  NATCH  statement  is  to  be  executed. 


The  NSI 


statement  will  be  executed  if  a 


MATCH  condition  is  found  to  exist  between  an  item  on 
the  queue  specified  and  the  available  transaction. 

NSI-fl 

The  NSI+1  statement  will  be  executed  if 
NOMATCH  is  found  to  exist  between  the  available  trans¬ 
action  and  any  items  on  the  specified  queue. 

Error  Conditions 

If  the  available  transaction  word  for  the 
current  CPU  item  is  zero  when  a  MATCH  statement  is 
executed  a  diagnostic  message  will  be  issued, and  the 
simulation  terminated. 

If  the  QUEUE  operand  specifies  the  name  of 
a  queue  which  contains  I/O  transaction  items  or  a  queue 
where  the  current  entry  is  zero,  a  diagnostic  message 
will  be  issued  and  the  simulation  terminated. 
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SELECT/PLACE 


The  SELECT/PLACE  statement  allows  the  user 


to  move  a  transaction  word  from  one  queue  to  another 
without  altering  the  current  CPU  item  in  any  way. 


STATEMENT  FORMAT  ] 

LABEL 

OP  CD 

OPERANDS 

SELPLC 

q-name  1,  q-name  2  (,AT,IOT) 

q -name  1 

The  "q-name  1”  field  specifies  the  name  of 


the  queue  from  which  the  AT  or  lOT  will  be  selected. 
q -name  2 

The  "q-n2une  2"  field  specifies  the  naune  of  the 
queue  onto  which  the  AT  or  lOT  selected  from  QUEUEl  will 
be  placed. 

The  AT  operand  specifies  that  both  "q-name  1"  and 
"q-naroe  2"  contain  a  transaction  item. 
lOT 

The  lOT  operand  specifies  that  both  "q-name  1"  and 
"q-narae  2"  contain  I/O  transaction  items. 


Error  Conditions 


If  either  or  both  of  the  ivo  queues  specified 
in  this  statement  do  not  contain  the  type  of  transaction 
specified  by  the  AT  or  lOT  operands  an  error  message 
will  be  issued  and  the  simulation  terminated. 


The  END  statement  must  be  the  last  statement 
of  every  routine.  The  END  statement  is  not  executable 
but  is  used  to  signify  the  end  of  every  assembly.  The 
statement  used  to  terminate  execution  of  a  routine  is 
the  TERM  statement. 

STATEMENT  FORMAT 


LABEL 


OP -CD 


OPERANDS 
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RECEIVING  CPU 


The  RCV  statement  is  used  to  specify  the  name 
of  the  CPU  which  is  to  receive  the  current  W/R  if  it  is 
other  than  CPU  number  one.  In  addition,  the  RCV  state¬ 
ment  may  be  used  to  specify  the  number  of  the  load  class 
entry  to  be  used  by  the  W/R  if  it  is  other  than  number 
one.  This  statement  must  come  after  a  JOB  statement  and 
before  an  END  statement. 


STATEME 

,NT  FORMAT  | 

I  .ARRI 

OP-CD 

OPERANDS 

RCV 

receiving-cpu-name,  load-class# 

receiving -cpu-name 

The  "receivi ng -cpu-name”  must  be  the  name  of 
the  CPU  which  is  to  receive  this  worker  routine  when  it 
is  introduced  to  the  system. 
load -class-# 

The  "load-class-#”  field  must  contain  an 
integer  number  from  1  to  15  which  specifies  the  load 
class  entry  to  be  used  by  the  W/R. 
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OPERATING  SYSTEM 


The  OS  statement  must  be  included  in  each 
operating  system  described  for  a  simulation  run.  The 
statement  describes  the  memory  module  that  the  oper¬ 
ating  system  is  to  occupy  as  well  as  the  CPUs  it  is  to 
control . 


STATEME 

-NT  FORMA 

T 

LABEL. 

OP-CD 

OPERANDS 

OS 

mem-name ,  epu-name  ( , epu-name ) 

mem-name 

The  "mem-name"  field  must  contain  the  name 
of  the  memory  module  the  operating  system  is  to  occupy. 
cpu-n^aae 

The  "epu-name"  field  must  contain  the  ncune  of 
the  CPU  which  the  operating  system  is  to  control. 
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ASSEMBLY 


The  ASSEMBLY  statement  is  used  to  delimit 
the  system  parameters  from  the  worker  routines.  In 
addition,  it  provides  the  user  with  control  over  the 
printing  of  the  assembly  output.  This  statement  must 
immediately  proceed  the  first  JOB  statement  in  the 
input  stream. 


STATEMENT  FORMAT 

LABEL  OP-CD  OPERANDS _ 

_ ftSSEMBLV  (PRINT,  NOPRINT) 


PRINT 


If  the  PRINT  option  is  specified  the  worker 
routine  object  code  will  be  printed  after  the  diagnostic 
messages . 

NOPRINT 

If  the  NOPRINT  option  is  specified  the  worker 
routine  object  code  will  not  be  printed. 

If  the  operand  is  given,  the  PRINT  option 


will  be  assumed. 
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INTERRUPT  VECTOR 


The  IV  statement  is  used  to  change  the  label 
which  specifies  the  starting  location  in  an  operating 
system  for  interrupt  processing.  Normally  the  user  will 
label  the  statement  which  is  to  receive  control  of  the 
CPU  when  a  specified  interrupt  occurs  with  an  interrupt 
name  as  shown  below.  However,  if  the  user  wauits  to  use 
a  name  which  is  different  from  the  one  specified,  he  may 
do  so  by  use  of  the  IV  statement. 


STATEME 

NT  FORMAT 

LABEL 

OP-CD 

OPERANDS 

IV 

oid-int-narae,new-int-name ,cpu-name  ( ,cpu-narae^ 

old-int-name 

The  "old-int-name”  field  must  contain  the  name 


by  which  the  interrupt  to  be  changed  is  currently  known 
to  the  system. 
new-int  -ntune 

The  "new-int -name"  field  must  contain  the  new 
name,  limited  to  six  characters,  by  which  this  interrupt 


is  to  be  known 
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effected 


Interrupt  Vector  Table 


The  first  ten  interrupts  in  the  system  are 
fixed  for  specific  interrupt  conditions  and  must  be 


referred  to  by 

the  following  standard  names: 

Interrupt  Name 

Interrupt  Condition 

1. 

lOTINT 

I/O  Termination 

2. 

RWINT 

Read  or  Write  Operation 

3. 

FNCINT 

Function  Operation 

4. 

CLiCINT 

Clock  Interrupt 

5. 

RCVINT 

Receive  Interrupt 

6. 

TRMINT 

Program  Termination 

7. 

EDSINT 

End  of  Seek  Operation 

8. 

OCINT 

Open  or  Close  Operation 

9. 

CD  LI  NT 

Call  with  Delay  Option 

10. 

CALINT 

Call  with  No  Delay  Option 

Interrupts  11  through  20  may  be  assigned 
functional  significance  by  the  user  but  must  be  referred 
to  by  the  following  names: 


11 


I  NTH 


12 .  INT12 

13 .  INT13 

14.  INT14 

15.  INT15 

16.  INTI 6 

17.  INT17 

18 .  INT18 

19.  INT19 


20 


INT20 
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APPENDIX  A 


WORKUG  PAPER 
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Entering  Data  Into  the  I.ibrary 


Facilities  are  provided  within  the  S-3 
Assembler  for  placing  Macro  Definitions,  Hardware 
Definitions,  and  Configuration  Data  into  the  library. 
These  facilities  have  been  provided  because  these  items 
must  be  formatted  by  the  Assembler  before  they  are  placed 
in  the  library,  and  no  attempt  should  be  made  to  enter 
these  items  into  the  library  without  using  the  Assembler. 

Anything  else  which  the  user  might  wish  to 
have  placed  into  the  system  library,  such  as  worker 
routines,  operating  systems,  etc.,  may  be  entered  as 
follows : 


^7  ELT  _  NNNNNN 


}DATA 


(ANY  CONTROL  CARD) 

Where  ^  is  a  7/8  punch  and  NNNNNN  is  the  6  character 
name  of  the  item  to  be  entered. 

This  data  may  then  be  retrieved  by  means  of 
the  COPY  statement  as  described  in  the  library  facility. 


WORKING  PAPER 
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working  paper 


Poisson  Distribution 


The  Poisson  Distribution  is  used  to  vary  the 
values  of  the  generation  interval  about  the  specified 
average  value.  That  is,  when  the  POISS  option  is 
specified  in  a  GENERATE  statement,  the  statement  does 
not  cause  a  transaction  to  be  generated  at  the  interval 
specified.  Rather,  the  interval  is  used  as  an  average 
value,  and  the  intervals  between  specific  generations 
is  varied  in  such  a  manner  as  to  preserve  the  specified 
value  as  the  average. 

The  Poisson  Distribution  is  the  analogue, 
for  discrete  events,  of  the  well  known  normal  distri¬ 
bution  (bell-shaped  curve).  The  Poisson  table  is  used 
as  follows.  When  a  GENERATE  statement  generates  a 
transaction,  S-3  then  computes  when  the  next  transaction 
is  to  be  generated  by  that  statement  and  places  it  on 
the  FEC.  Using  the  POISS  option,  this  computation  is 
performed  by  first  generating  a  random  number  between 
0  and  99.  This  random  number  is  then  used  as  the 


argument  for  a  table  look-up  in  the  Poisson  table. 

This  table  actually  contains  values  not  for  every 
integer  from  0  to  99,  but  for  every  5.  That  is,  there 
are  twenty  values  in  the  table,  one  for  the  range  of 
0-4,  one  for  the  range  of  5-9,  auid  so  on  through  the 
range  of  95-99.  The  number  found  in  the  Poisson  table 
is  then  multiplied  by  the  interval  given  in  the  GENERATE 
statement,  to  obtain  the  next  generation  interval. 
Altering  the  S-3  Poisson  Distribution  Table 

The  Poisson  Distribution  Table  in  S-3  is 
initialized  by  Subroutine  ZERO.  The  table  is  located 
in  AT20(81)  to  AT20(100)  in  Subroutine  ZERO  and  consists 
of  twenty  words . 

Since  a  random  draw  is  made  from  one  of  these 
twenty  values,  the  sura  of  the  twenty  values  in  the  table 
for  a  normal  distribution  must  be  equal  to  20  in  order 
to  preserve  the  average  of  the  table.  To  create  a  flat 
or  null  distribution,  all  twenty  entries  in  “ihe  table 
may  be  initialized  to  a  value  of  one. 


APPENDIX  D 


S-3  Assembler  Statement  Summary 


PART  I:  Hardware  Definitions  and  Configuration  r~'ta 
STATEMENT  FORMAT 


LABEL 


OP-CD 

OPERANDS 

CPU-DEF 

CPU-END 

cpu-id  ( 

,LIB,CAT,NCAT) 

MEM-DEF 

MEM -END 

mem -id  ( 

,LIB,CAT,NCAT) 

CHAN-DRF 

CHAN-END 

chan-id 

(,LIB,CAT,NCAT) 

DRV-DEF 

DEV-END 

dev-name 

(,LIB,CAT,NCAT) 

CONFIG 

(config-name )  (, LIB, CAT) 

CPU 

cpu-name,  cpu-id 

MEM 

mera-name,  raein-id,  cpu-name  .  .  . 

CHANNEL 

chan-name,  chan -id,  cpu-name  .  . 

CONTROL 

(IN,0Ur,I/0) ,  ctl-narae,  chan-name 

DEVICE 

( SEIZE, NOSEIZE ) ,  dev-name,  dev-id 

CONFIG-END 

ctl-name  .  .  , 

PART  II;  System  Control  Parameters 


STATEMENT 

LABEL 


symbol 


FORMAT 


OP -CD 


TF-DEF 

TABLE 

TF-END 

Q-DEF 

QUEUE 

Q-END 

FILE-DEF 

RF 

RFC 

FILE-END 

LC-DEF 

LOAD 

LC-END 


RC-DEF 

RUN 

RC-END 

TAB-CTL 

STAT-CTL 

STATISTICS 

GEQU 

LEQU 


OPERANDS 

dev -name  #-files 
Nil,  N12,  N13 

q-neone,  entries  (,AT,IOT)  ( ,FIFO,LIFO,PRI 

file-name,  dev-name,  rel-loc,  buff-len, 
rec/buff,  buff /file 

old -file -name,  new -file -name  (, dev-name) 

( , rel-loc ) 

class-#,  cpu-name  (^,cpu-name) 

loading-cpu-naane ,  cpu-name  (, cpu-name) 

(ON, OFF)  (,T1)  (,T2)  (,  ,  .  .) 

(ON, OFF)  (,ST1)  (,ST2)  (,...) 

minutes,  count 

value 

value 


symbol 


PART  III; 


S-3  Processing  Statements 


STATE^5ENT 


LABEL 


FORMAT 


OP-CD 

OPERATES 

ACTIV 

job -name 

ALLOC 

mem-name  1 ,  mem-name  2 

ASSEMBLY 

BUFF 

(PRINT, NOPRINT) 

CALL 

job-naime,  (DLY,NODLY) 

CLOCK 

time 

CLOSE 

of -name ,  ( REWIND , NOREWIND ) 

COMPUT 

CYCLE 

DALLOC 

inst,  (mark) 

DCYCLE 

int-name 

DESTROY 

(ATjIOT) 

DISABL 

(ALL,  int-ncime) 

ENABLE 

(ALL,  int-name) 

EOF 

of -name,  loc 

EXAM-F 

q-name 

EXAM-L 

q-name 

EXAM-N 

q-name 

EXEC 

EXIT 

int-name 

FUNCTN 

fno 

GEN 

interval,  (FIX,POISS),  limit,  priority 

INTER 

lOADV 

epu-name,  int-name 

lOREADY 

(q-name) 

lOTERM 

q -name 

JOB 

j  Ob  -name ,  (OS ,  PW ,  BUS ,  SCI ) ,  ( noENT ,  NREEN' 

LOOP 

count ,  loc 

MATCH 

q-name 

MEMORY 

raem-ncune  1,  mem-name  2  (, q-name) 

MEM-1 

inst,  char 

MEM-2 

dec-field,  dec-len,  bin-fields,  bin-len 
float-fields,  float-len 

PART  III:  S-3  Processing  Statements 


STATEMENT 


LABEL 


FORMAT 


OP -CD 

OPERANDS 

MOVE 

char 

MOVE-E 

char 

OF 

of -name , 

rf-name,  buff -no. 

(XOSEIZE, 

SEIZE-DEV,  SEIZE-FILE) 

OPEN 

of -name , 

(INPUT, OUTPUT) 

OS 

mem-najne , 

cpu-ncune  ( ,  cpu-naane ) 

PACK 

mem -name 

1 ,  mem-name  2 

PERI PH 

q-name 

PLACE 

(AT,IOT), 

q-ncone 

PRINT 

of -name, 

spaces 

RCV 

receiving 

-cpu-name,  load-class# 

READ 

of -name 

RECEIV 

RESET 

switch 

REIURN 

SEEK 

SELECT 

(AT,IOT), 

q-name 

SELPLC 

q -name  1 , 

q-name  2''(,AT,I0T) 

SET 

switch 

SUB 

loc 

SWITCHES 

TERM 

( job-neime ) 

TEST 

switch 

TRA 

loc 

TRA-P 

PERCENT , LOC 

WRITE 

of -name 

WORKING  PAPER 
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MACRO  DEFINITIONS 


The  S-3  Assembler  may  be  used  to  define 
macros  and  place  them  into  the  library*  However,  a 
macro  may  not  be  used  in  the  same  run  it  is  defined 
in.  A  macro  definition  must  be  enclosed  between  a 
rOEF  and  ar.  MEND  statement.  The  format  used  for 
defining  macros  is  shovm  in  the  following  figure. 


■—  —  '  ■ 

uABEL 

OP -CD 

— 

OPERANDS  1 

MDEF 

S 

! 

< 

( &svm') 

macro-name 

I 

( &ara) ( ,&ara. .  .)  ' 

(  .stmt-var. )  (&sym, s^rm .Sfara)  (*) 

( &ara.  On -cd,  macro-name') 

( &aTc(*)  ,ooerar.df  I 

. 

1 

. 

i 

i 

*  comments 

MEND 

t 


The  first  line  of  code  above  shows  the  proper 
use  of  the  MDEF  statement. 

The  second  line  above  shows  the  format  for  a 
Macro  Prototype  statement.  The  prototype  statement  is 
an  exact  replica  of  the  statement  which  will  be  used  to 
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t 

i 

invoke  the  use  of  this  macro  during  the  course  of  an 
assembly.  A  detailed  description  of  the  fields  which 
may  be  used  is  provided  below. 

Si  sym 

The  ’&  sym'  field  as  shown  above  may  be  replaced 
by  a  macro  symbol  of  up  to  twelve  characters. 

A  macro  symbol ,  or  symbol  variable ,  must  begin 
with  an  ampersand  followed  by  an  alphabetic 
character  followed  by  amy  alphameric  character. 

If  the  '&  sym*  field  is  coded,  the  label  pro¬ 
vided  with  a  macro  call,  if  any,  may  be  sub¬ 
stituted  into  the  macro  expansion.'" 

macro -name 

The  'macro-name'  field  must  contain  the  name 
(up  to  six  alphameric  characters)  by  which  this 
macro  will  be  referenced  during  the  course 
of  an  assembly.  Care  must  be  taken  to  ensure 
that  the  'macro-name'  provided  does  not  duplicate 
any  entry  in  the  table  of  contents  for  the  Program 
Complex  File  used  during  assembly. 
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&  arg 

The  ’&  arg'  operand  nay  be  used  to  pass  parameters 
to  the  macro  during  an  assembly.  The  operajids 
used  when  a  macro  is  invoked  replace  every 
occurrence  of  the  symbolic  argument  coded  in 
the  macro  definition. 

The  third  line  of  code  above  shows  the  format 
for  a  macro  statement.  A  detailed  descriptio:.  of  the 
possible  fields  follows : 

.stmt-var. 

If  the  '.stmt-var.'  field  is  used  'stmt-var' 
must  be  replaced  with  any  two  alphabetic 
characters.  The  generation  of  this  statement 
may  then  be  controlled  by  means  of  the  MSET 
statement  as  shown  later  on. 

&  sym 

If  the  user  wants  to  have  a  statement  in  the 
macro  expansion  labeled  the  seune  as  the  label 
supplied  with  the  macro  call,  the  statement  in 
the  macro  definition  must  have  the  same  symbolic 
variable  as  the  protot3/pe  statemenc. 
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If  the  user  wants  to  have  a  statement  in  the 
macro  expansion  labeled  for  reference  elsewhere 
in  the  macro  expan ‘^ion  a  syiiibol  may  be  used 
to  label  the  statement.  Note  that  care  must 
be  taken  to  ensure  that  the  symbol  is  not 
duplicated  in  the  rest  of  the  assembly,  and 
that  the  same  macro  may  not  be  invoked  more 
than  once  unless  the  '*»  operand  is  included 
for  all  labels. 


If  the  user  wants  to  be  able  to  provide  a 
label  for  a  statement  when  the  macro  is  invoked 
then  the  symbolic  variable  used  to  describe 
that  operand  in  the  prototype  statement  should 
be  coded  as  the  label  for  that  statement. 


The  symbol  may  be  appended  to  any  of  the 

permissable  labels  of  a  macro  statement  if  the 
user  wants  to  insure  that  all  labels  in  the 
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program  are  unique.  If  the  symbol  is  used 
a  two  digit  macro  level  number  is  appended 
to  the  symbol  provided.  Therefore,  if  the  '** 
symbol  is  used,  the  maximum  length  of  the 
symbol  is  10  alphameric  characters.  Caution 
must  be  taken  to  insure  that  if  the  '*•  symbol 
is  used,  every  reference  to  the  symbol  it  is 
appended  to,  also  has  the  *.  Otherwise,  those 
symbols  will  be  unresolved. 


arg 

If  the  user  wants  to  pass  an  operation  code  to 
the  macro  expansion  when  the  macrc  is  invoked, 
the  symbolic  argument  coded  in  the  protot}^e 
statement  may  be  coded  as  the  operation  code 
of  a  macro  statement.  When  the  macro  is  invoked, 
the  operation  code  supplied  as  an  operand  to 
the  macro  will  replace  the  symbolic  argument 
used  as  an  operation  code  in  the  macro  state¬ 


ment. 


f 

t 
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op-cd 

If  the  operation  code  to  be  used  in  a  macro 
statement  is  known  when  the  macro  is  defined 
then  it  may  be  coded  in  the  ‘op-cd*  field. 


The  user  may  invoke  other  macros  within  the 
definition  of  a  new  macro.  Macros  may  be 
nested  to  any  level,  and  may  have  a  maocimum 
of  50  operands. 


&  arg 

If  the  argument  for  a  macro  statement  is  to 
be  supplied  when  the  macro  is  expanded,  the 
'&  arc’  field  from  the  prototype  statement 
should  be  coded  in  the  macro  statement .  When 
the  macro  is  invoked,  the  argument  supplied 
in  the  macro  call  will  be  used  to  substitute 


for  the  symbolic  argument. 
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Operand 

II'  the  operand  for  a  macro  statement  is  known 
at  the  time  *he  macro  is  defined  it  may  be 
coded  as  a  normal  operand,  rather  than  as  a 
symbolic  operand. 


If  the  user  wants  to  reference  a  s'^'’tement 
label  ivhich  makes  use  of  the  macro  level 
counter,  then  the  operand  should  be 
appended  to  that  label  for  every  reference. 

Lines  4  ^und  5  are  used  to  show  that  the  type 
of  statement  shown  in  line  3  may  be  repeated 
as  often  as  necessary.  The  assembler  is 
capable  of  handlinn  approximately  400  macro 
statements  for  a  single  macro  definition. 

Line  6  demonstrates  that  coimments  may  be 
included  within  a  macro  definition.  However, 
all  coruments  withi.i  a  macro  definition  must 
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be  on  cornments  cards.  Th...  may  not  be  placed 
on  the  same  line  as  macio  statement. 

Line  7  shows  the  proper  use  of  the  MEND  state 
merit . 


% 
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y_AG?0  EXAMPLES 


L  SVM 

,SD 

SYM 

EXAM-F 

iA 

TRA 

LEST  ^ 

S3 

AA 

TRA 

SD 

EXAM-X 

iA 

TRA 

SC 

TRA 

iEST  * 

:-EXD 

ALACRO 

-."i 

EXD-IO 

^oARCn 

DO } lOTo 

E:o-i0 

EX.AM-- 

EQ 

O 

TRA 

EXITl 

VJ 

TESTOl 

lOTERM 

DQ 

G 

TRA 

EXIT2 

G 

EX.AM-X 

DQ 

G 

TRA 

EXITl 

v:> 

TRA 

TESTOl 

RM,£XIT1,£XIT2 


END  OF  MACRO 
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MICRO  CALL  13 


SEARCH 

IQ.IOREADl ,EXIT1,EXIT2 

EXA>!-r 

IQ 

TRA 

EXIT! 

GTSST02 

lORS.ADY 

IQ 

NJ 

IRA 

EXIT2 

EXA.V-X 

IQ 

TRA 

EXITl 

KJ 

TRA 

TEST02 

EXD  Or 

macro 

MA.CRO  D 

E.'INiTIOX  2 

.'DEF 

i.xolt: 

&.A  1 ,  &.A2 ,  i A3 , 5cA*t  ,  3i3 1 ,  (5c32 

•  aA  • 

Or 

FXi-Ei ,  ic.Al  j  1 ,  XOi>Ej.Zii- 

-AA. 

OF 

FI  LE2 ,  i.A2 , 1 ,  XOSEIZE 

.AJi. 

OF 

FI  LE3 ,  A3 , 1 ,  .XOSEIZE 

..AA. 

OF 

FI LE4 ,  -A4 ,  i ,  XOSEIZE 

.33. 

OF 

FI LE5 ,31,1, XOSEIZE 

.33. 

OF 

FI LE6 ,32,1, XOSEIZE 

.33. 

OF 

FI  IJE7 ,33,1,  XOSEIZE 

.33. 

OF 

FI LE8 ,34,1, XOSEIZE 

MEND 

The  COPY  stateaent  is  used  to  take  infornation 


ron  the  systen  library  and  insert  it  into  the  input 
ata  strean  at  the  current  location.  A  COPY  statenent 
:ay  not  bring  ^clother  COPY  statenent  Inco  the  input 
;trean  and  a  COPY  statement  nay  not  be  included  in  a 
:acro  definition.  However,  a  COPY  statenent  nay  bring 
:acro  calls  or  macro  definitions  into  the  input  stream. 

TP>tSVT  r  OR  VAT 

I  I 

Ed _ !  OP-CD  I  Q-^EPAXDS _ 

f 

COPY  I  data -name 

_ i _ I _ 

ata-nane 

The  "data-nane"  field  must  contain  the  name 
linited  to  6  characters)  by  which  the  da.ta  to  be 
nought  into  the  input  stream  is  known. 
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The  MEQU  statement  is  provided  for  use 


synod 

The  syiuhol  supplied  in  this  field  will  be 


entered  into  the  local  syrtbol  table  for  the  worker 
routine  in  which  this  aacro  is  used. 

H  ■  3  ,  C 

The  value  assigned  to  the  symbol  above  will 
be  calculated  as  follows: 

value  =  (A*B)  /  C 

Any  or  all  of  the  operands  a,  b,  c  may  be  substituted 
for  by  the  use  of  macro  variable^.. 
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IF 


The  IF  statement  provides  the  macro  generator 
with  a  limited  logical  capability. 


S  LABEb  S  OP-CD 
ilF 


I  OPESAXDS 


S  stmt -varl,val-l, stmt -var2,val-2( , 


stmt-varl 

The  field  "stmt-varl"  must  contain  a  2  character 
statement  variable. 
val-1 

If  the  "stmt-varl"  has  a  current  value  of 
"val-1"  then  the  other  (stmt-var,  val )  operand  pairs 
will  be  treated  as  if  they  were  operands  of  a  MSET 
statement.  If  the  current  value  of  "stmt-varl"  is  not 
equal  to  "val-1"  no  MSET  operation  will  take  place. 
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STORE 


The  STORE  statersent  provides  the  user  with 
the  ability  to  place  input  to  the  assembler  into  the 
library.  UTien  a  STORE  statement  is  interpreted,  all 
data  from  the  input  stream  is  placed  onto  the  CUR 


output  file  until  an  EXD-STCRE  statement  is  encountered 


ST.ATEMEXT  FORMAT 

»■ 

t 

LABEL  •  OP-CD  ji  OPERANDS 

> 

STORE  (  file -name 

Statements  to  be  placed  in  library  go  here. 

'.END -STORE 

- - 1— I.r  ■  ■  _ _ _ 

li 

_ i 

f le  -name 

The  ''file-name”  field  must  contain  the  name 


by  which  this  data  will  be  knovjn  in  the  library.  This 
field  is  limited  to  six  characters.  The  first  of  which 
must  be  alphabetic. 

NOTE ; 

Between  a  STORE  and  an  END -STORE  no  statement 
with  a  CAT  option  is  accepted. 
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UPDATE 


The  UPDATE  macro  prov/ices  the  user  vjith  the 


ability  xo  generate 

a  simple  update  program  model  with 

a  minimum  of  effort 

4 

STATEMENT  FORMAT  | 

1  * 

LABEL  j  OP-CD 

1 

•  OPERANDS  1 

j  ! 

1  ( sym )  1  UPDATE 

1  input -of -name ,output-of -name , trans-of -  | 

!  i  i  1 

j  1  }  name ,prob , inst , records  j 

input -of -name 

The  ’’input-or-name"  field  must  contain  the 


name  of  the  input  master  file  as  specified  in  the 
ordinal  file  statement. 
output -of -name 

The  "output -of -name"  field  must  contain  the 
name  of  the  output  master  file  as  specified  in  the 
ordinal  file  statement. 

~:rans-of -na.'. 

The  "trans-of -name”  field  must  contain  the 
name  of  tne  input  transaction  file  as  specified  in 
•-'r.e  ordinal  file  statement. 


The  "prob"  field 


r.;ust  contain  the  probability 
that  any  one  rec.ord  on  the  input  master  file  will  have 
a  transaction  to  be  processed  against  it.  This  prob¬ 
ability  must  be  expressed  as  a  number  from  1-99. 
inst 

The  "inst”  fieic  must  contain  the  number  of 
instructions  required  to  process  one  transaction. 
records 

The  "records"  field  must  contain  the  number 
of  records  on  the  input  master  file. 

EX  A^^?LE 

Suppose  the  user  wants  to  generate  a  model 
of  an  update  program  which  has  a  10,000  record  master 
file,  with  5%  transaction  and  1000  instructions  required 
or  eacn  tr  j.nsaction .  inrs  example  wouxd  be  cooed  as 


-  O  -L  X  v.y  .V  • 


C? 


•  *  »«  i  ^  ^  f*  j  j  I  4^  "%  ■"  a'  X  I  •- 

*'0oT  3  I\f^J  3  4  .  SiilZE-*''!  Li, 
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g::x  iG,rix,i,io 

UPDATE  >T.STIN ,  MASTOuT ,  TRAXS ,  5 , 1000 , 10000 


The  SORT  macro  is  used  to  generate  a  model 
of  a  typical  sort  package.  The  user  is  required  to 
provide  ordinal  file  statimcnts  for  the  input  file, 
work  files,  and  the  output  file.  The  SORT  macro  is 


currently 

capable 

of  handling 

a  balanced  sort  for  four 

or  six  wor 

'k  files. 

i  STATEMENT  PCR?v'A.T 

j 

j  LABEL  1 

CP-CD 

f0PER.ANDS 

1 

. 

i  ( syn:)  1 

SORT 

1  input-of -name  , output -of -name  ,  #-v;ork-f  iles, 

)  i 

1 _ L 

1  records , 

merges,  mem-records 

inout-of -name 

The  "input -of -name"  field  must  contain  the 


name  of  the  input  file  as  specified  in  the  ordinal  file 
statement . 
output -of -name 

* 

The  "output-of-name"  field  must  contain  the 
name  of  the  output  file  as  specified  in  the  ordinal  file 


statement . 


#-work-files 


The  "# -work-files"  field  must  contain  the 
number  of  work  files  available  to  this  sort.  Work 
files  must  be  named  WOKKOl,  I1KIRKO2,  etc.  The  nui&ber 
of  work  files  specified  must  equal  four  or  six. 

Records 

The  "records"  rile  must  specify  the  number 
of  records  contained  in  the  input  file.  The  number  of 
records  in  the  input  file  should  be  am  even  multiple 
of  the  nximber  of  records  which  can  be  contained  in 
memory  as  specified  in  the  "mem-records"  field, 
me roes 

The  "merges"  field  must  contain  the  number 
of  merge  passes  required  by  the  sort. 
roen-records 

The  "mem-records"  field  must  contain  the 
number  of  records  which  can  be  entered  into  memory 
at  one  time.  This  is  dependent  on  the  amount  of  data 


storage  available 
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EXAMPLE 

Suppose  t'.iQ  user  wants  to  sort  10,000  fifty 
character  records  using  four  work  files.  For  this 
example  we  will  assume  that  the  file  has  a  certadn 


Notice  that  no  END  statement  is  required 
for  this  job  since  it  will  be  generated  by  the  SORT 
mac  CO . 


MERGE 


The  MERGE  macro  is  used  to  generate  a  model 
of  a  typical  merge  package.  The  user  is  required  to 
provide  ordinal  file  statements  for  the  files  to  be 
merged  as  well  as  the  output  file.  The  MERGE  macro 
is  currently  capable  of  handling  from  two  to  six 


input  files. 


1 

STATE^^ENT  PORMAT  i 

LABEL 

OP -CD 

;  s 

OPERANDS  i 

(sym) 

MERGE 

no -input , records , output -of -name 

no -input 

The  "no-input"  field  must  contain  the  total 


number  of  input  files  to  be  merged.  This  field  must 
contain  a  number  from  two  to  six.  The  nair.es  of  the 
input  files  as  specifies  in  ordinal  file  statements 
must  be  INPUTOl , INPUT02 ,  etc. 
records 

The  "records"  field  must  contain  the  total 


number  of  records  on  all  of  the  input  files. 
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cutout -of -naraa 

The  "output-of-nane"  field  must  contain  the 
ordinal  file  na.ae  for.  the  file  on  which  the  merged 
output  is  to  be  written. 
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EXANPLE 

Suppose  the  user  wants  to  generate  a  model 
to  represent  the  merging  of  three  files  onto  a  single 
file.  The  three  input  files  contain  about  10,000 
records.  This  example  is  coded  as  follows: 


MSTART 


JOB 

OF 

OF 

OF 

OF 

MEM-1 

GEN 

MERGE 


MERGEl , SCI , NREENT 
INPUTOl , RFl , 2 ,SEI2E-DEV 
INPUT02 , RF2 , 2  ,SEIZE-DEV 
INPUT03 ,RF3 ,2 ,SEIZE-DEV 
OUTPUT , RF4 , 2 , SEIZE-DEV 
13,34 
1, FIX, 1,10 
3,10000, OUTPUT 


Notice  that  no  END  statement  need  be  coded 


since  it  is  Generated  by  the  MERGE  macro. 
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ISORT 


The  ISORT  macro  is  used  to  generate  an  internal 


sort  routine.  The  ISORT^ macro  assumes  that  items  to  be 
sorted  are  currently  in  memory,  and  that  sufficient 
memory  is  available. 


I  STATEMENT  FORMAT  i 

LABEL 

OP -CD  1  OPERANDS 

( sym) 

ISORT  1  items , fields , length 

items 

The  "items"  field  must  contain  the  nximber  of 


items  to  be  sorted.  The  total  number  of  items  to  be 
sorted  must  not  exceed  1,000.  •  If  it  is  necessary  to 
simulate  the  internal  sorting  of  more  than  1,000  items 
multiple  calls  on  ISORT  are  necessary. 
r ields 

The  "fields"  field  must  contain  the  total 
number  of  control  fields  on  which  the  items  are  to 


be  sorted 
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links 

The  "links"  field  must  contain  the  length 
of  the  items  to  be  sorted.  If  the  items  to  be  sorted 
are  of  variable  length,  then  the  average  length  should 
be  supplied. 


EXAMPLE 


Suppose  the  user  has  an  array  containing 
500  items  to  be  sorted  on  two  keys.  The  average 
length  of  the  items  is  40  characters.  This  example 
is  coded  as  follows : 

INTSORT  ISOLT  500,2,40 

ihe  ISORT  macro  does  not  generate  an  END 
statement  and  therefore  may  be  used  anywhere  in  a 
worker  routine. 
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MATH  MACROS 


There  are  seven  mathematical  routines  which 


can  be  simulated  by  means  of  macros  as  shown  below. 


STATEMENT  FORMAT! 


LABEL 


(sym) 


( sym) 


( syr.' 


(sym) 


(sym 


i  (sym) 


I 


(sym) 


number 


OP -CD 


LOG 


SORT 


ABS 


ATAy. 


SIN 


CCS 


!  OPERANDS 


■ 

! number , digits 


{number , digits 


number 


EXP  number , digits 


!  number , di g i t  s 


number , digits 


number , digits 


The  "number"  field  must  contain  the  total 


number  of  times  the  specified  mathematical  routine  is 
to  be  evaluated. 


digits 

The  "digits"  field  must  contain  the  number  of 
decimal  places  to  v.’hich  the  expression  is  to  be  evaluated. 
The  maximur.  number  of  places  w.nich  can  currently  be  .‘val- 


uated  is  sevv-.  . 


EXA.vr?LE 


Suppose  the  user  wants  to  represent  ICO  calls 
on  a  square  root  function  for  which  the  result  must  be 
accurate  to  plus  of  minus  .0001.  The  example  would  be 
coded  as  follows : 

SQRT  *30,4 

The  number  of  terms  to  be  evaluated  for  the 
purpose  of  the  math  macros  are  drawn  from  HASTINGS, 
CECIL  JR.,  P'Tjoroxi nations  for  Dlcita]  Computers, 
Princeton,  1955,  Princeton  University  Press, 
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Statistics  Output 

The  followir.g  section  describes  the  statis¬ 
tical  records  which  will  be  ivritten  by  the  S-3  Simulator. 
These  records  will  be  written  to  a  tape  which  may  then 
be  processed  in  order  to  accuijulate  aind  print  any  desired 


statistics 


* 
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W/R  Creation  -  Figure  1 

The  record  shown  in  Figure  1  will  be  written 
each  time  a  transaction  is  accepted  into  the  system  by 
the  RECEIVE  statement .  The  record  code  is  a  36  bit 
field  containing  the  unique  code.  The  record  code  of 
1  indicates  that  this  is  a  W/R  creation  record.  The 
W/R  number  field  is  a  12  bit  field  and  contains  the 
number  of  the  worker  routine  created.  The  TI  number 
field  is  a  24  bit  field  and  contains  the  number  of  the 
transaction  item  representing  this  worker  routine's 
execution.  The  current  time  field  contains  a- 72  bit 
double  precision  floating  point  number  where  the  time 
is  expressed  in  microseconds. 
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W/R  =  12  bits 

TI  =  24  bits 

RECORD  CODE  -  36  bits 

CURRENT  TIME  =  72  bits  floating  point 


W/R  CREATION  RECORD 


FIGURE  1 
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I/O  Seize  -  Figure  2 

The  record  shown  in  Figure  2  will  be  written 
each  time  a  file  or  device  is  seized  by  means  of  the 
PERIPHERAL  statement.  The  record  code  field  contains 
the  number  2  which  indicates  that  this  is  an  I/O  Seize 
record.  The  W/R  number  field  contains  the  number  of 
the  worker  routine  which  caused  this  record  to  be 
generated.  The  TI  number  field  contains  the  number 
of  the  Transaction  Item  associated  with  this  record. 

The  current  time  field  is  a  double  precision  floating 
point  n’ornber  where  the  tine  is  expressed. .in  micro¬ 
seconds.  The  next  word  contains  the  ordinal  file 
number,  real  file  number,  and  device  number.  The  last 
word  of  this  record  contains  a  code  which  indicates 
what  has  been  seized.  If  the  last  word  contains  a  1 
the  real  file  specified  has  been  seized  by  this  state¬ 
ment.  If  the  last  word  contains  a  2  the  device  specified 


has  been  seized 


RECORD  CODE  =  2 


_ 

W/R 

j  .TI  # 

"  '  - - 

CURRENT  TIME 

OF  # 

!  j 

RF  tt  j  DEV  .»  j 

1  = 
2  = 

R.F.  SEIZED  1 

DEV  SEIZED  1 

RECORD  CODE  =  36  bits 
^^/R  #  =  12  bits 
TI  #  =  24  bits 

CURRENT  TIME  =  72  bits  floating  point 
OF  #  =  12  bits 
RF  #  =  12  bits 
DEV  #  =  12  bits 


I/O  SEIZE  RECORD 


FIGURE  2 


I/O  Release  -  Figure  3 

The  record  shown  in  Figure  3  will  be  written 
each  time  a  file  or  device  is  released  by  means  of  the 
CLOSE  statement.  The  record  code  field  contains  the 
number  3  which  indicates  that  this  is  an  I/O  Release 
record.  The  W/R  numbe;  field  contains  the  number  of 
the  worker  routine  associated  with  this  record.  The 
TI  number  field  contains  the  niimber  of  the  Transaction 
Item  associated  with  this  record.  The  current  time 
field  contains  a  double  precision  floating  point  number 
where  the  time  is  expressed  in  microseconds.  The  fifth 
word  of  the  record  contains  the  ordinal  file  number, 
real  file  number,  and  device  number.  The  last  word  of 
this  record  contains  the  code  which  indicates  whether 
the  file  or  the  device  has  been  freed  by  this  operation. 
If  the  last  word  contains  a  1  the  real  file  described 
has  been  released.  If  the  last  word  contains  a  2  the 
device  specified  has  been  released. 
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RECORD  CODE  =  3 


W/R  # 


XI  # 


CURRENT  TIME 


OF  # 

R.F. 

DEV  # 

1  =  R.^.  FREE 

2  =  DEV  FREE 

RECORD  CODE  =  36  bits 
W/R  #  =  12  bits 
TI  #  =  24  bits 

CURRENT  TIME  =  72  bits  iloating  point 
OF  #  =  12  bits 
R.F,  #  =  12  bits 
DEV  #  =  12  bits 


I/O  RELEASE  RECORD 


FIGURE  3 
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Memory  Alloca.ion  -  Figure  4 

y 

The  record  shown  in  Figure  4  will  be  written 
each  time  an  ALLOCATE  statement  is  successfully  executed. 
The  record  code  field  contains  the  number  4  which  indi¬ 
cates  that  this  is  a  Memory  Allocation  record.  The  W/R 
number  field  contains  the  number  of  the  worker  routine 
associated  with  this  record.  The  TI  number  field  con¬ 
tains  the  number  of  the  Transaction  Item  associated 
with  this  record.  The  current  time  field  contains  a 
double  precision  floating  point  number  where  the  time 
is  expressed  in  microseconds.  The  fifth  word- of  this 
record  contains  the  number  of  pages  of  memory  allocated 
for  instruction  areas.  The  sixth  word  of  this  record 
contains  the  number  of  pages  allocated  for  data  areas. 

The  seventh  word  of  thi^.  record  contains  the  number  of 
pages  allocated  for  I/O  storage.  Each  of  these  last 
three  fields  contains  a  single  precision  floating  point 


number 
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RECORD  CODE  =  4 

- - 

W/R  # 

TT  # 

_ — ^ 

CURRENT 

TIME 

INST  PAGES 

DATA  PAGES 

I/O  PAGES 

RECORD  CODE  =  36  bits 
W/R  #  =  12  bits 
TI  #  =  24  bits 

CURRENT  TIME  -  72  bits  floating  point 
INST  PAGES  =  36  bits  floating  point 
DATA  PAGES  =  36  bits  floating  point 
I/O  PAGES  s  36  bits  floating  point 

MEMORY  ALLOCATION  RECORD 


PIGURE  4 


Memory  Deallocation  -  Figure  5 


The  record  shown  in  Figure  5  will  be  written 
each  time  a  DEALLOCATE  statement  is  successfully  executed. 
The  record  code  field  contains  the  number  5  which  indi¬ 
cates  that  this  is  a  Memory  Deallocation  record.  The 
W/R  number  field  contains  the  number  of  the  worker 
routine  associated  with  this  record.  The  TI  number 
field  contains  the  number  of  the  Transaction  Item 
associated  with  this  record.  The  current  time  field 
contains  a  double  precision  floating  point  number  where 
the  time  is  expressed  in  microseconds. 


CURRENT  TIME 


RECORD  CODE  =  36  bits 
W/R  #  =  12  bits 
TI  #  =  24  bits 

CURRENT  TIME  =  72  bits  floating  point 


MEMORY  DEALLOCATION  RECORD 


FIGURE  5 
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Worker  Routine  Termination  ->  Figure  6 

The  record  shown  in  Figure  6  will  be  written 
each  time  a  worker  routine  transaction  is  eliminated 
from  the  system  by  means  of  the  DESTROY  statement. 

The  record  code  field  contains  the  number  6  which 
indicates  that  this  is  a  Worker  Routine  Termination 
record.  The  W/R  number  field  contains  the  number  of 
the  worker  routine  associated  with  this  record.  The 
TI  number  field  contains  the  number  of  the  Transaction 
Item  associated  with  this  record.  The  current  time 
field  contains  a  double  precision  floating  point  number 
where  the  time  is  expressed  in  microseconds.  The  CPU 
time  used  field  contains  a  double  precision  floating 
point  number  where  the  time  is  expressed  in  raicroseconds . 
The  seventh  word  of  this  record  contains  the  number  of 
interrupts  generated  by  this  transaction.  The  eighth 
word  of  this  record  contains  the  number  of  times  this 
rransaction  was  interrupted  externa] ''v.  The  last  two 
fields  contain  a  full  word  integer  value. 
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RECORD  CODE  = 

6 

W/R  # 

TI 

# 

— 

CURRENT  TIME 


CPU  TIME 
USED 


#  interrupts  generated 

_ by  W/R _ 

#  times  W/R  inte''rupted 

externally 

RECORD  CODE  =  26  bits 
W/R  #  =  12  bits 
n  #  =  24  bits 

CURRENT  TI'»vIE  =  72  bits  floating  point 
CPU  TIME  USED  =  72  bits  floating  point 
INTERRUPTS  GENERATED  =  36  bits 
TIMES  W/R  INTERRUPTED  =  36  bits 


W/R  TERMINATION  RECORD 


FIGURE  6 
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TI  or  lOTI  SELECT  -  Figure  7 

The  record  shown  in  Figure  7  will  be  written 
each  time  a  transaction  item  or  I/O  transaction  item  is 
selected  from  a  queue.  The  record  code  field  contains 
the  number  7  which  indicates  that  this  is  a  TI  or  lOTT 
Select  record.  The  W/R  number  field  contains  the  number 
of  the  worker  routine  associated  with  this  record.  The 
TI  number  field  contains  the  number  of  the  Transaction 
Item  associated  with  this  record.  The  queue  field  is 
a  double  precision  floating  point  number  where  the 
elapsed  time  on  the  queue  is  described  in  microseconds . 

The  eighteen  right  most  bits  in  the  fifth  word  of  this 
record  contain  a  code  describing  the  item  selected  from 
the  specified  queue.  If  these  bits  contain  a  zero  the 
item  selected  was  a  transaction  item  as  described  in  the 
first  word  of  this  record.  If  these  two  digits  contain 
a  number,  the  numbei;  is  the  ordinal  file  number,  for  which 
the  I/O  transaction  item  selected  from  the  specified  queue, 


was  generated 
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RECORD  CODE  =  .^6  bits 
W/R  #  =  12  bits 
TI  #  =  24  bits 

QUEUE  TIME  =  72  bits  f  loating  point., 
QUEUE  #  =  18  bits 
CODE  =  18  bits 


TI  OR  lOTI  SELECT  RECORD 


FIGUT?E  7 
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0/S  Cycle  End  -  Figure  8 

The  record  shown  is  Figure  8  will  be  written 
each  time  a  CPU  comes  out  of  the  cycle  state.  The 
record  code  field  contains  the  number  8  which  indicates 
that  this  is  an  0/S  Cycle  End  record.  The  second 
word  contains  the  number  of  the  CPU  which  has  just 
stopped  cycling.  The  cycle  time  field  contains  a 
double  precision  floating  point  number  where  the  amount 
of  time  spent  cycling  is  expressed  in  microseconds. 


RECORD  CODE  =  36  bits 
CPU  #  =  36  bits 

CYCLE  TIME  =  72  bits  floating  point 


0/S  CYCLE  END  RECORD 


FIGURE  8 
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I/O  Operation  -  Figure  9 

The  record  shown  in  Figure  9  will  be  written 
each  time  an  I/O  operation  is  initiated  by  means  of  the 
I/O  ADVANCE  statement.  The  record  code  field  contains 
the  number  9  wliich  indicates  that  this  is  an  I/O  oper¬ 
ation  record.  The  W/R  number  field  contains  the  number 
of  the  worker  routine  associated  with  this  record.  The 
TI  number  field  contains  the  number  of  the  Transaction 
Item  associated  with  this  record.  The  third  word  of 
this  record  contains  the  ordinal  f ile  number,  channel 
number,  and  control  number  used  by  this  I/O  operation. 
The  fourth  word  of  this  record  contains  the  amount  of 
device  time  required  for  this  I/O  operation.  The  fifth 
word  of  this  record  contains  the  amount  of  control  unit 
time  required  for  this  I/O  operation.  The  sixth  word  uf 
this  record  contitins  the  amount  of  channel  time  required 
for  this  I/O  operation.  Each  of  these  three  fields  are 
full  word  floating  point  numbers,  where  the  time  is  ex¬ 
pressed  in  Microseconds.  The  last  word  contains  the  I/O 
Transaction  Item  type. 


RECORD  CODE  =  9 


W/R  # 


OF  # 


DEV 


CTL 


CHAN 


lOTI 


CH  # 


TI  # 


CTL  # 


TIME 


TIME 


TIME 


TYPE 


RECORD  CODE  =  36  bits 
W/R  /jf  =  12  bits 
TI  #  =  24  bits 
OF  #  =  12  bits 
CH  #  =  12  bits 
CTL  #  =  12  bits 

DEV  TIME  =  bits  floating  point 
CTL  TIME  =  36  bits  floating  point 
CHAN  TI>E  =  36  bits  f loa  :ing  point 
lOTI  TYPE  »  36  bits 


I/O  OPERATION  RECORD 


FIGURE  9 


Assembler  Name  File 
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Asserabler  Name  File 


The  following  section  describes  a  file  which 
will  be  written  by  the  assembler  and  which  will  be 
available  to  the  statistical  analysis  prograim.  In 
general,  items  of  interest  arc  supplied  with  names 
when  input  is  prepared  for  the  assembler.  These  names 
are  then  translated  into  numbers  by  che  assembler  for 
use  by  the  simulator.  As  shown  in  the  section  titled 
"Statistics  Output"  the  simulator  refers  to  items  of 
interest  by  number.  Therefore,  the  assembler  provides 
a  dictionary  for  converting  the  simulator,  numljers  back 
into  the  names  supplied  by  the  user  when  the  input  was 
prepared  for  the  assembler. 

Each  block  in  this  file  will  be  proceeded  by 
a  two  word  record.  The  first  word  will  contain  a  block 
code  describing  the  block  which  follows.  The  second  word 
will  contain  a  count  of  the  number  of  records  in  the  block. 
The  following  section  describes  these  dictionary  records. 
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Job  Name  File  -  Figure  1 

Each  record  in  the  Job  Name  File  will  contain 
the  name  of  the  job  left  justified  and  right  filled  with 
blanks  in  the  first  two  words.  The  third  word  will  con~ 
tain  the  starting  number  of  the  records  in  the  ordinal 
file  name  directory  for  this  job. 


BLOCK  CODE  =  1 


NUMBER  OF  RECORDS 


JOB  NAME  BLOCK  HEADER 


job-naiae  PART  I 

job -name  PART  II 

STARTING  OF  # 

JOB  NAME  RECORD 

JOB-NAME  =  72  bits 
STARTING  OF  #  =  36  bits 


JOB  NAME  FILE 


FIGURE  1 
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Ordinal  File  Name  File  -  Figure  2 

Each  record  in  the  Ordinal  File  Name  File  will 
contain  the  ordinal  file  name  left  justified  and  right 
filled  with  blanks  in  the  first  two  words.  The  third 
word  will  contain  the  number  of  the  real  file  to  which 
this  ordinal  file  refers.  The  fourth  word  will  contain 
the  number  of  buffers  assigned  to  this  file. 
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OF  NAME  BLOCK  HEADER 


ORDINAL  FILE  NAME  RECORD 

OF -NAME  =  72  bits 
real  file  #  =  36  bits 
NUMBER  OF  BUFFERS  =  36  bits 

ORDINAL  FILE  NAME  FILE 


FIGURE  2 
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Real  File  Name  File  -  Figure  3 

Each  record  in  the  Real  File  Name  File  will 
contain  the  real  file  name  left  justified  and  right 
filled  with  blanks  in  the  first  two  words.  The  third 
word  will  contain  the  number  of  the  device  on  which  this 
real  file  resides.  The  fourth  word  indicates  the  relative 
location  of  this  file  on  the  device  specified  in  the 
third  word  of  this  record.  The  fifth  word  will  contain 
the  size  of  each  block  in  this  file  expressed  in  char¬ 
acters.  The  sixth  word  will  contain  the  number  of  records 
per  block  in  this  real  file.  And  the  last  word  in  this 
record  will  contain  the  total  number  of  blocks  contained 


in  this  file 
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BLOCK  CODE  =  3 


MUMBER  OF  RECORDS 


RF  NAME  BLOCK  HEADER 


i;  rf-name 

PART 

I 

“1 

E 

U 

!;  rf -name 

PART 

II 

j 

Is 

« 

^  dev  # 

i 

I  REL  LOC 


I  BLOCK  SIZE 
#  REC/BLOCK 
BLOCKS  xN  FILE 

REAL  FILE  NAME  RECORD 

RF-NAME  =  72  bits 
DEV  #  =  36  bits 
RELATIVE  LOCATION  =  36  bits 
BLOCK  SIZE  =  36  bits 
#  REC/BLOCK  =  36  bits 
BLOCKS  IN  FILE  =  36  bits 

REAL  FILE  NAME  FILE 


FIGURE  3 
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Device  Name  File  -  Figure  4 

Each  record  in  the  Device  Name  File  will 
contain  the  device  name  left  justified  and  the  right 
filled  with  blanks  in  the  first  two  words.  The  third 
word  of  this  record  will  contain  a  code  describing  the 
device  type. 


BLOCK  CODE  =  4 


NUMBER 

OF  RECORDS 

DEV  NAME 

BLOCK  HEADER 

dev -name 

PART  I 

dev -name 

part  II 

dev -type 

DEVICE  NAME  RECORD 


DEV-NAME  =  72  bits 
DEV-TYPE  =  36  bits 


DEVICE  NAME  FILE 


FIGURE  4 


( 
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Channel  Name  File  -  Figure  5 


Each  record  in  the  Channel  Name  File  will 
contain  the  name  of  the  channel  left  justified  and 
right  filled  with  blanks  in  the  first  two  words.  The 
third  word  of  each  record  will  contain  the  code 


describing  the  channel  type 


BLOCK  CODS  =  5 


NUMBER  OF  RECORDS 


CHANNEL  NAME  BLOCK  HEADER 


chan -name 

PART 

I 

chan -name 

PART 

II 

CHANNEL  TYPE 

CHANNEL  NAME  RECORD 


CKAN«NAME  =  72  bits 
CHANNEL  TYPE  =  36  bits 


CHANNEL  NA.'Qi  FILE 


FIGURE  5 


Each  record  in  the  Control  Name  File  will 
contain  the  control  name  left  justified  and  right 
filled  with  blanks  in  the  first  two  words. 
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BLOCK  CODE  •=  6 


NUMBER  OF  RECORDS 


CONTROL  NAME  BLOCK  HEADER 


ct 1-name 

PART 

I 

ct 1-name 

PART 

II 

CONTROL  NAME  RECORD 


CTL-NAME  =  72  bits 


CONTROL  NAME  FILE 


FIGURE  6 
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Queue  Name  File  -  Figure  7 


Each  record  in  the  Queue  Name  File  will 
contain  the  name  of  the  queue  left  justified  and  right 


filled  with  blanks  in  the  first  two  words. 


BLOCK  CODE 


7 


QUEUE  name  record 


QUEUE-NAME  =  72  bits 


QUEUE  NA>iE  FILE 


FIGURE  7 


Each  record  in  the  CPU  Name  File  will  contain 
the  name  of  the  CPU  left  justified  and  right  filled 
with  blanks  in  the  first  two  words.  The  third  word 
will  contain  the  size  of  the  logical  data  unit  in  bits, 
The  fc  rth  word  will  contain  the  number  of  characters 


per  logical  data  unit 


CPU -NAME  PART  I 


CPU-NAMS  RECORD 


CPU-NAME  =  72  bits 
LDU  SIZE  =  36  bits 
CHAR/LDU  =  36  bits 


CPU  NANE  FILE 


FIGURE  8 


Memory  Name  File  -  Figure  9 


y 


Each  record  in  the  Memory  Naune  File  will 
contain  the  name  of  the  Memory  left  justified  and 
right  filled  with  blanks  in  the  first  two  words.  The 
third  word  will  contain  the  size  of  the  memory  access 
unit.  The  fourth  word  will  contain  the  memory  size  in 
memory  units.  The  fifth  word  will  contain  the  page 


size  in  memory  units. 


MEMORY  NAME  BLOCK  HEADER 


MEMORY  NA;^,  RECORD 
MEM-NAME  =  72  bits 

MEM  ACC  UNIT  =  36  bits 

MEM  SIZE  =  36  bits 

PAGE  SIZE  =  36  bits 

MEMORY  NAME  FILE 


FIGURE  9 


